그래프 API 버전

URL `/?id={url}`

게시물 또는 게시물의 댓글에서 공유된 URL을 나타냅니다.

자세한 내용은 뉴스 탭 인덱싱 API 문서를 참조하세요.

읽기

게시물 또는 게시물의 댓글에서 공유된 URL에 대한 정보를 가져옵니다.

요구 사항

유형	설명
액세스 토큰	이 요청을 보낼 때는 모든 액세스 토큰을 사용할 수 있습니다.
기능	해당 사항 없음.
페이지 작업	해당 사항 없음.
권한	해당 사항 없음.

제한 사항

반환된 참여 값은 정확하지 않지만 URL에 대한 사용자 참여를 반영합니다.
앱 한 개 기준 시간당 한 URL에 GET 요청을 10개까지만 보낼 수 있습니다.

매개변수

요청을 보강하기 위해 다음 쿼리 문자열 매개변수를 포함합니다.

매개변수	설명
`access_token` 필수 문자열	액세스 토큰.
`fields` 문자열	요청하고자 하는 필드를 쉼표로 구분한 리스트.
`id` 문자열	공유할 URL.
`scopes` 문자열	범위를 쉼표로 구분한 리스트.

필드

속성 이름	설명	유형
`app_links`	이 URL과 관련된 AppLinks 데이터(사용 가능할 경우).	`AppLinks`
`id`	URL 자체.	`string`
`engagement`	사용자가 URL과 상호작용하는 여러 가지 방식의 수. 참여 값은 의도적으로 정밀하게 표시하지 않지만 URL에 대한 사용자 참여를 정확히 반영한다는 것은 신뢰해도 됩니다.	`object`
`comment_count`	URL에 달린 댓글 수.	`int`
`comment_plugin_count`	사이트에서 댓글 플러그인으로 수집된 플러그인의 댓글 수.	`int`
`reaction_count`	URL에 대한 공감 수.	`int`
`share_count`	URL이 공유된 횟수.	`int`
`og_object`	이 URL과 기본적으로 연결되는 오픈 그래프 개체.	`OGObject`
`id`	개체 ID.	`string`
`description`	개체 설명(사용 가능할 경우).	`string`
`title`	개체 제목(사용 가능할 경우).	`string`
`type`	개체 유형.	`og:type`
`updated_time`	개체를 마지막으로 업데이트한 시기.	`datetime`

예

게시물 또는 댓글에 공개된 URL에 대한 정보를 가져오려면 https://graph.facebook.com으로 GET 요청을 보냅니다. 이때 id 매개변수는 URL로 설정하고 URL과 관련된 모든 필드 및 게시물이나 댓글을 공개한 사용자 또는 페이지에서 요청한 액세스 토큰을 포함합니다.

다음 예시는 사용자 액세스 토큰으로 대표되는 사용자가 공유한 https://www.facebook.com이라는 URL에 대한 참여를 나타냅니다.

가독성을 높이기 위해 형식을 지정했습니다.

curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

요청이 성공하면 앱이 공유된 URL에 대해 다음과 같이 참여 수를 수신합니다.

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

만들기

이 엔드포인트에서는 해당 작업을 수행할 수 없습니다.

업데이트

URL을 업데이트합니다.

요구 사항

유형	설명
액세스 토큰	이 요청을 보낼 때는 모든 액세스 토큰을 사용할 수 있습니다.
기능	해당 사항 없음.
페이지 작업	해당 사항 없음.
권한	해당 사항 없음.

예

게시물이나 댓글에 공개된 URL에 대한 정보를 업데이트하려면 https://graph.facebook.com으로 POST 요청을 보냅니다. 이때 id 매개변수는 URL로 설정하고, scrape 매개변수는 true로 설정하며, URL과 관련된 모든 fields 및 게시물이나 댓글을 공개한 사용자 또는 페이지가 요청한 액세스 토큰을 포함합니다.

다음 예시에서는 사용자 액세스 토큰으로 대표되는 사용자가 공유한 https://www.facebook.com/my-update라는 URL을 업데이트합니다.

가독성을 높이기 위해 형식을 지정했습니다.

curl -i -X POST \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com/my-update
    &scrape=true
    &access_token={user-access-token}"

요청이 성공하면 앱이 공유된 URL에 대해 다음과 같이 참여 수를 수신합니다.

{
  "success": true
}

쿼리 문자열 매개변수

요청을 보강하기 위해 다음 쿼리 문자열 매개변수를 포함합니다.

매개변수	설명
`access_token` 필수 문자열	액세스 토큰.
`fields` 문자열	요청하고자 하는 필드를 쉼표로 구분한 리스트.
`id` 필수 문자열	업데이트할 URL. 이 URL은 `scrape` 매개변수에 간섭하지 않도록 인코딩되어야 합니다.
`scrape` 필수 부울	값은 `true`이어야 합니다.

요청 예시

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

응답 예시

{
  "success": true
}

삭제

이 엔드포인트에서는 해당 작업을 수행할 수 없습니다.

URL /?id={url}

읽기

요구 사항

제한 사항

매개변수

필드

예

만들기

업데이트

요구 사항

예

쿼리 문자열 매개변수

요청 예시

응답 예시

삭제

URL `/?id={url}`