API Video

Đăng chéo video

Tài liệu này giải thích cách sử dụng API Video để đăng video lên nhiều Trang mà không cần tải video lên từng Trang. Ví dụ: nếu có một Trang chính gồm vài Trang phụ, bạn có thể tải và đăng video lên Trang chính, sau đó đăng Video lên tất cả Trang phụ mà không cần phải tải video lên từng Trang.

Để đăng chéo Video, bạn phải có khả năng thực hiện tác vụ CREATE trên Trang và cho phép đăng Video lên Trang cụ thể. Bạn cần có ID của Video và ID của Trang mà mình muốn đăng Video. Bạn cũng cần có mã truy cập Trang của Trang ban đầu đăng Video cũng như của Trang mà bạn muốn đăng.

Bạn có thể dùng API này để xác định xem Video đã đủ điều kiện để đăng chéo chưa hay có phải là video đăng chéo không. Bạn cũng có thể dùng API này để xác định cách cho phép đăng chéo lên tất cả các Trang thuộc quyền quản lý của Trình quản lý kinh doanh và lấy danh sách các Trang mà bạn có thể đăng chéo.

Hãy xem hướng dẫn Đăng thước phim của chúng tôi để biết thông tin về cách đăng chéo một thước phim lên Trang Facebook của cộng tác viên.

Giới hạn

Nếu một video đã được đăng chéo lên Trang của bạn nhưng bạn không có Vai trò trên Trang ban đầu đăng video này, bạn sẽ không thể thay đổi bất kỳ Quyền nào của Video.

Bước 1. Cho phép đăng chéo

Để đăng chéo một Video lên nhiều Trang, bạn phải cho phép đăng chéo Video đó lên những Trang này.

Bạn sẽ cần:

Gửi yêu cầu POST đến điểm cuối Video:

POST /{api-version}/{video-id}
  ?allow_crossposting_for_pages=[{page_id:{page-a-id},allow:true},{page_id:{page-b-id},allow:true}]
  &access_token={page-access-token}

Thêm các thông số sau:

Tên thông sốGiá trị

allow_crossposting_for_pages

Mảng JSON gồm các ID Trang mà bạn muốn đăng video. Đặt allow thành true để cho phép đăng hoặc false để không cho phép đăng.

access_token

Mã truy cập Trang của Trang ban đầu đăng video.

Yêu cầu mẫu

curl -X POST \
  "https://graph.facebook.com/v7.0/2918040388250909" \
  -F "allow_crossposting_for_pages=[{page_id:104371193424796,allow:true},{page_id:115969103185286",allow:true}] \
  -F "access_token=EAABkW..."

Phản hồi mẫu

{
  "success": true
}

Bước 2. Đăng chéo Video

Bạn sẽ cần:

Gửi yêu cầu POST đến điểm cuối Video trên Trang:

POST /{api-version}/{page-id}/videos
    ?crossposted_video_id={video-id}
    &access_token={page-access-token}

Thêm các thông số sau:

Tên thông sốGiá trị

crossposted_video_id

ID video của Video mà bạn sẽ đăng chéo.

access_token

Mã truy cập Trang của Trang mà bạn sẽ đăng video.

Yêu cầu mẫu

curl -X POST \
  "https://graph.facebook.com/104371193424796/videos?crossposted_video_id=2918040388250909&access_token=EAABk..."

Phản hồi mẫu ở định dạng JSON

{
  "id":"577600939847873"
}

Lấy điều kiện đăng chéo video

Để xác định xem một Video có đủ điều kiện để đăng chéo hay không, hãy gửi yêu cầu GET đến điểm cuối Video, trong đó có trường is_crossposting_eligible.

Bạn sẽ cần:

GET /{api-version}/{video-id}
   ?fields=is_crossposting_eligible
   &access_token={page-access-token}

Yêu cầu mẫu

curl -X GET \
  "https://graph.facebook.com/v7.0/2918040388250909" \
  -F "is_crossposting_eligible" \
  -F "access_token=EAABkW..."

Phản hồi mẫu

{
  "is_crossposting_eligible": true,
  "id": "2918040388250909"
}
Tên thông sốGiá trị

is_crossposting_eligible

Cho biết liệu Video có được phép đăng chéo hay không.

access_token

Mã truy cập Trang của Trang ban đầu đăng Video.

Lấy trạng thái đăng chéo video

Để xác định xem Video có phải là Video đăng chéo hay không, hãy gửi yêu cầu GET đến điểm cuối Video, trong đó có trường is_crosspost_video.

Bạn sẽ cần:

GET /{api-version}/{video-id}
  ?fields=is_crosspost_video
  &access_token={page-access-token}

Thêm các thông số sau

Tên thông sốGiá trị

is_crosspost_video

Cho biết liệu đó là Video gốc hay Video đăng chéo.

access_token

Mã truy cập Trang của Trang ban đầu đăng Video.

Yêu cầu mẫu

curl -X GET \
 "https://graph.facebook.com/v7.0/577600939847873?fields=is_crosspost_video&access_token=EAABk..."

Phản hồi mẫu

{
  "is_crosspost_video": true,
  "id": "577600939847873"
}

Lấy danh sách các Trang đủ điều kiện để đăng chéo

Bạn sẽ cần:

Gửi yêu cầu GET đến điểm cuối CrosspostWhitelistedPages trên Trang.

GET {page-id}/crosspost_whitelisted_pages
  &access_token={page-access-token}

Yêu cầu mẫu

curl -X GET \ "https://graph.facebook.com/v7.0/2918040388250909/crosspost_whitelisted_pages&access_token=EAABk..."

Phản hồi mẫu

{
  "crosspost_whitelisted_pages": {
    "data": [
      {
        "name": "Obsession, by Margaret",
        "id": "115969103185286"
      },
      {
        "name": "Cisco Dog",
        "id": "422575694827569"
      }
    ],
    "paging": {
      "cursors": {
        "before": "QVFIUn...",
        "after": "QVFIUk4..."
      }
    }
  },
  "id": "1353269864728879"
}

Cho phép đăng chéo lên tất cả các Trang thuộc Trình quản lý kinh doanh của bạn

Để cho phép đăng chéo lên tất cả các Trang thuộc quyền quản lý của Trình quản lý kinh doanh, hãy gửi yêu cầu POST đến điểm cuối Video.

Bạn sẽ cần:

POST /{api-version}/{video-id}
  ?allow_bm_crossposting=true
  &access_token={page-access-token}

Thêm các thông số sau

Tên thông sốGiá trị

allow_bm_crossposting

Đặt allow thành true để cho phép đăng hoặc false để không cho phép đăng.

access_token

Mã truy cập Trang của Trang ban đầu đăng video.

Yêu cầu mẫu

curl -X POST \
  "https://graph.facebook.com/v7.0/2918040388250909?allow_bm_crossposting=true&access_token=EAABkW..."

Phản hồi mẫu

{
  "success": true
}

Thông tin chi tiết

Mỗi Video đăng chéo đều có video_id riêng. Bạn có thể xem thông tin chi tiết về video từ mỗi Video và Trang.

Xem thêm

Để biết thêm thông tin về cách đăng chéo, hãy truy cập vào Trung tâm trợ giúp của chúng tôi.