Facebook Page API

​

Đăng bài lên Facebook

{
  "post": "The best FB post ever #best https://www.facebook.com", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["facebook"]
}

• Facebook sẽ tự động hiển thị bản xem trước của liên kết trong bài đăng trừ khi có hình ảnh hoặc video đi kèm. Trong ví dụ trên, hình ảnh sẽ hiển thị. Việc bỏ hình ảnh sẽ khiến bản xem trước liên kết hiển thị.
• Nếu video của bạn không kết thúc bằng phần mở rộng video đã biết như mp4, vui lòng sử dụng tham số isVideo. Xem endpoint /post để biết chi tiết.
• Facebook cũng hỗ trợ gửi phương tiện mà không có nội dung bài đăng. Nếu bạn không muốn bao gồm nội dung bài đăng, hãy gửi một chuỗi rỗng post: "".
• Xem Facebook Media Guidelines và Facebook Authorization để biết thêm thông tin.

​

Hình ảnh Carousel

{
  "faceBookOptions": {
    "carousel": {
      // The URL of the "See More At" button - required
      "link": "URL of See More At...",
      "items": [
        // 2 min, 10 max elements in the array
        {
          "name": "Image name", // optional
          "link": "URL when image clicked", // required
          "picture": "URL of image" // required
        },
        {
          "name": "Image name",
          "link": "URL when image clicked",
          "picture": "URL of image"
        }
      ]
    }
  }
}

• Tham số link ở cấp cao nhất là URL ở cuối carousel.
• items là một mảng đối tượng chứa các giá trị sau. Tối thiểu 2 phần tử và tối đa 10 phần tử trong mảng items.
• picture - URL của hình ảnh carousel.
• link - URL khi hình ảnh được nhấp.
• name - (tùy chọn) Hình ảnh được hiển thị trong mỗi thẻ hình ảnh.

​

Facebook Reels

{
  "post": "The description of the video",
  "platforms": ["facebook"],
  "mediaUrls": ["https://img.ayrshare.com/012/reel.mp4"],
  "faceBookOptions": {
    "reels": true,
    "title": "Super title for the Reel", // optional
    "thumbNail": "https://img.ayrshare.com/012/reel-thumbnail.jpg" // optional
  }
}

• reels: Đặt thành true để đăng video lên Reels. Bắt buộc nếu bạn muốn đăng lên Facebook Reels.
• title: Tiêu đề của video với tối đa 255 ký tự. Trên 255 ký tự sẽ bị cắt bớt. Tùy chọn.
• thumbNail: Thumbnail (hình ảnh bìa) của video. Thumbnail phải là URL đến một file JPEG hoặc PNG. Thumbnail phải có kích thước dưới 10MB. Tùy chọn.

{
  "action": "post",
  "status": "error",
  "code": 108,
  "message": "Facebook Error: Facebook cannot process your post at this time. Please try again. ",
  "detailsData": {
    "id": "104619420979033_36930641143",
    "verifyReelsUrl": "https://api.ayrshare.com/history/36930641143?searchPlatformId=true&platform=facebook",
    "verifyReelsIn": "2024-01-26T00:07:05.170Z",
    "postUrl": "https://www.facebook.com/1046194209_36930641143",
    "reels": true
  },
  "retryAvailable": true,
  "platform": "facebook"
}

​

Facebook Stories

• Facebook Stories không hỗ trợ nội dung bài đăng — bất kỳ văn bản nào được cung cấp trong trường post, bao gồm cả mentions, sẽ bị bỏ qua.
• Một ảnh hoặc video được tải lên cho một story không thể đã được sử dụng trong một bài đăng đã xuất bản trước đó.
• Một video story không thể vượt quá 60 giây.
• Bật Stories Archive để có thể GET stories.

{
  "post": "", // Ignored by stories
  "platforms": ["facebook"],
  "mediaUrls": ["https://img.ayrshare.com/012/stories.mp4"],
  "faceBookOptions": {
    "stories": true
  }
}

​

Chú thích phương tiện

{
  "faceBookOptions": {
    "mediaCaptions": ["This is my best pic", "😃 here is the next one"]
  }
}

​

Gắn thẻ vị trí

// Using the Facebook Page Id - must be associated with a location
{
  "faceBookOptions": {
    "locationId": 7640348500 // Guggenheim Museum Page Id
  }
}

​

Nhắm mục tiêu khán giả

1. Facebook Targeting: Điều này cho phép bạn xác định đối tượng cho bài đăng của mình dựa trên các yếu tố như tuổi, giới tính, vị trí, và mối quan hệ. Bằng cách đặt các tham số này, bạn có thể đảm bảo bài đăng chỉ được hiển thị với những người đáp ứng các tiêu chí đã chỉ định.
2. Facebook Feed Targeting: Tùy chọn này cho phép bạn tinh chỉnh thêm tính hiển thị của bài đăng trong News Feeds của đối tượng mục tiêu.

​

Targeting

• ageMin: Giới hạn độ tuổi tối thiểu có thể xem bài đăng. Các giá trị được chấp nhận là 13, 15, 18, 21, hoặc 25. Các độ tuổi khác sẽ bị từ chối.
• countries: Còn được gọi là geofencing, bạn có thể giới hạn các quốc gia có thể xem bài đăng. Mảng mã quốc gia. Số lượng quốc gia tối đa có thể được nhắm mục tiêu là 25. Nếu bạn cần nhắm mục tiêu hơn 25 quốc gia, hoặc hạn chế một số quốc gia nhất định, vui lòng xem Hạn chế quốc gia trang Facebook.

{
    "faceBookOptions": {
        "targeting": {
            "ageMin": 18,
            "countries": ["DE", "BR"]
    }
}

​

Feed Targeting

• ageMin: Giới hạn độ tuổi tối thiểu có thể xem bài đăng. Giá trị integer 13 trở lên. Mặc định là 0.
• ageMax: Giới hạn độ tuổi tối đa có thể xem bài đăng. Giá trị integer 65 trở xuống.
• countries: Còn được gọi là geo targeting, bạn có thể chỉ ra các quốc gia có thể xem bài đăng. Mảng mã quốc gia.
• collegeYears: Nhắm mục tiêu tuổi tốt nghiệp đại học để xem bài đăng. Mảng các số nguyên cho năm tốt nghiệp từ đại học.
• educationStatuses: Nhắm mục tiêu trạng thái giáo dục để xem bài đăng. Mảng các số nguyên để nhắm mục tiêu dựa trên trình độ học vấn. Dùng 1 cho trung học, 2 cho đại học, và 3 cho cựu sinh viên.
• genders: Nhắm mục tiêu giới tính để xem bài đăng. Mảng các số nguyên để nhắm mục tiêu giới tính cụ thể. 1 nhắm mục tiêu tất cả người xem nam và 2 là nữ. Mặc định là nhắm mục tiêu cả hai.
• relationshipStatuses: Nhắm mục tiêu trạng thái mối quan hệ để xem bài đăng. Mảng các số nguyên để nhắm mục tiêu dựa trên trạng thái mối quan hệ. Dùng 1 cho độc thân, 2 cho ‘đang trong mối quan hệ’, 3 cho đã kết hôn, và 4 cho đã đính hôn. Mặc định là tất cả các loại.

{
  "feedTargeting": {
    "ageMax": 30,
    "ageMin": 26,
    "countries": ["DE", "BR"],
    "genders": [1, 2],
    "relationshipStatuses": [1, 2]
  }
}

​

Văn bản thay thế (Alt Text)

{
  "faceBookOptions": {
    // Array of Alt Texts
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}

​

Thumbnail video

{
  "faceBookOptions": {
    "thumbNail": "https://octodex.github.com/images/Fintechtocat.png"
  }
}

​

Tiêu đề video

{
  "faceBookOptions": {
    "title": "The best video ever!"
  }
}

​

GIF động

{
  "randomPost": true,
  "platforms": ["facebook"],
  // Set to true if the GIF URL does not end in .gif or .GIF
  "isVideo": false,
  // Only one URL is allowed in the array
  "mediaUrls": ["https://img.ayrshare.com/012/cat.gif"]
}

​

Nhắc tên Facebook Page (Mention)

​

Nhắc tên với tên Page

{
  "post": "This is the best social media api by @Ayrshare"
}

​

Nhắc tên với Page ID

{
  "post": "This is the best social media api by @[738681876342836]" // Ayrshare Page ID
}

​

Tìm Facebook Page ID

​

Endpoint Brand

​

Tại Facebook.com

1. Từ Facebook News Feed, nhấp vào Pages trong menu bên trái.
2. Nhấp vào tên Page của bạn để đến Page.
3. Nhấp vào About ở đầu Page. Nếu bạn không thấy, hãy nhấp vào More▼.
4. Cuộn xuống để tìm Page ID của bạn bên dưới MORE INFO.

• Nếu Facebook Page có URL như https://www.facebook.com/ayrshare-1234567890 thì ID là 1234567890.
• Nếu Facebook Page có URL như:

​

Bật Page Mentions

1. Xem với tư cách Page của bạn, hãy nhấp vào hình ảnh profile của page ở góc trên bên phải.
2. Nhấp vào Settings & Privacy -> Settings.
3. Trong menu Settings, nhấp vào Privacy.
4. Nhấp vào Page and Tagging.
5. Cuộn xuống Reviewing.
6. Chuyển đổi cài đặt để cho phép gắn thẻ và mentions.

​

Meta Business Suite

​

Bài đăng nháp

{
  "faceBookOptions": {
    "draft": true
  }
}

​

Thời gian lên lịch xuất bản

{
  "faceBookOptions": {
    "scheduledPublishDate": "2023-09-28T21:44:06Z" // Future date in UTC
  }
}

​

Xem trước liên kết

{
  "faceBookOptions": {
    "link": "https://www.ayrshare.com/instagram-hashtag-guide/"
  }
}

​

Facebook Ads

​

Giới hạn ký tự

​

Thông tin bổ sung

​

Làm cách nào để thêm ngắt dòng hoặc văn bản phong phú vào bài đăng Facebook?

​

Tại sao tôi thấy “Published by Ayrshare” trên một bài đăng?