동영상 API

동영상 교차 게시

이 문서에서는 동영상을 각 페이지에 업로드하지 않고 동영상 API를 사용하여 여러 페이지에 동영상을 게시하는 방법을 설명합니다. 예를 들어 여러 하위 페이지가 있는 상위 페이지 한 개가 있을 경우, 동영상을 상위 페이지에 업로드하여 게시한 후 각 페이지에 동영상을 업로드하지 않고도 해당 동영상을 모든 하위 페이지에 게시할 수 있습니다.

동영상을 교차 게시하려면 페이지에서 CREATE 작업을 수행하고 동영상을 특정 페이지에 게시하도록 활성화할 수 있어야 합니다. 동영상 ID와 동영상을 게시할 페이지의 ID, 동영상이 원래 게시되었던 페이지와 동영상을 게시하고자 하는 페이지의 페이지 액세스 토큰이 필요합니다.

API를 사용하여 동영상이 이미 교차 게시가 가능한지 또는 교체 게시된 동영상인지 확인하고 비즈니스 관리자에서 관리하는 모든 페이지에 교차 게시를 활성화하고 교차 게시할 페이지 리스트를 가져오는 방법을 알아볼 수 있습니다.

공동 작업자의 Facebook 페이지에 릴스를 교차 게시하는 방법에 대한 자세한 내용은 릴스 게시 가이드를 참조하세요.

제한 사항

동영상이 페이지에 교차 게시되었지만 동영상이 원래 게시되었던 페이지에서 역할이 부여되지 않았을 경우, 동영상 권한을 변경할 수 없습니다.

1단계. 교차 게시 활성화

동영상을 여러 페이지에 게시하려면 해당 페이지에 대한 동영상의 교차 게시를 활성화해야 합니다.

다음과 같은 항목이 필요합니다.

POST 요청을 동영상 엔드포인트로 보냅니다.

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}

다음과 같은 매개변수를 포함합니다.

매개변수 이름값

allow_crossposting_for_pages

동영상을 게시하고자 하는 페이지 ID의 JSON 배열입니다. allow를 true로 설정하여 게시를 활성화하거나 false로 설정하여 게시를 비활성화합니다.

access_token

동영상이 원래 게시되었던 페이지의 페이지 액세스 토큰입니다.

요청 샘플

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..."

응답 샘플

{
  "success": true
}

2단계. 동영상 교차 게시

다음과 같은 항목이 필요합니다.

POST 요청을 페이지 동영상 엔드포인트로 보냅니다.

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

다음과 같은 매개변수를 포함합니다.

매개변수 이름값

crossposted_video_id

교차 게시하려는 동영상의 ID입니다.

access_token

동영상을 게시하는 페이지의 페이지 액세스 토큰입니다.

요청 샘플

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

JSON 응답 샘플

{
  "id":"577600939847873"
}

동영상 교차 게시 요건 확인

동영상을 교차 게시할 수 있는지 확인하려면 is_crossposting_eligible 필드를 포함하여 GET 요청을 동영상 엔드포인트로 보냅니다.

다음과 같은 항목이 필요합니다.

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

요청 샘플

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

응답 샘플

{
  "is_crossposting_eligible": true,
  "id": "2918040388250909"
}
매개변수 이름값

is_crossposting_eligible

동영상을 교차 게시할 수 있는지 여부를 표시합니다.

access_token

동영상이 원래 게시되었던 페이지의 페이지 액세스 토큰입니다.

동영상 교차 게시 상태 확인

동영상이 교차 게시된 동영상인지 확인하려면 is_crosspost_video 필드를 포함하여 GET 요청을 동영상 엔드포인트로 보냅니다.

다음과 같은 항목이 필요합니다.

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

다음과 같은 매개변수를 포함합니다.

매개변수 이름값

is_crosspost_video

동영상이 원본인지, 교차 게시된 동영상인지 표시합니다.

access_token

동영상이 원래 게시되었던 페이지의 페이지 액세스 토큰입니다.

요청 샘플

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

응답 샘플

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

교차 게시가 가능한 페이지 리스트 가져오기

다음과 같은 항목이 필요합니다.

GET 요청을 페이지 CrosspostWhitelistedPages 엔드포인트로 보냅니다.

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

요청 샘플

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

응답 샘플

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

모든 비즈니스 관리자 페이지에 대해 교차 게시 활성화

비즈니스 관리자가 관리하는 모든 페이지에 교차 게시를 활성화하려면 POST 요청을 동영상 엔드포인트로 보냅니다.

다음과 같은 항목이 필요합니다.

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

다음과 같은 매개변수를 포함합니다.

매개변수 이름값

allow_bm_crossposting

allow를 true로 설정하면 게시가 활성화되고 false로 설정하면 게시가 비활성화됩니다.

access_token

동영상이 원래 게시되었던 페이지의 페이지 액세스 토큰입니다.

요청 샘플

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

응답 샘플

{
  "success": true
}

인사이트

각 교차 게시된 동영상에는 고유한 video_id가 있습니다. 각 동영상과 페이지에서 동영상 인사이트를 확인할 수 있습니다.

기타 참고 자료

교차 게시에 대한 자세한 내용은 고객 센터를 방문하여 확인하세요.