Instagram 그래프 API

IG 사용자 콘텐츠 게시 제한

IG 사용자의 현재 콘텐츠 게시 사용량을 나타냅니다.

만들기

지원되지 않는 작업입니다.

읽기

GET /{ig-user-id}/content_publishing_limit

IG 사용자가 일정 기간에 IG 컨테이너를 게시한 횟수를 가져옵니다. 전체 게시 절차에 대한 자세한 내용은 콘텐츠 게시 가이드를 참조하세요.

요구 사항

유형요구 사항

액세스 토큰

사용자

권한

instagram_basic
instagram_content_publish
pages_read_engagement


또한 앱 사용자가 타게팅된 IG 사용자에 연결된 페이지에서 비즈니스 관리자를 통해 역할을 부여받은 경우 다음 중 하나도 필요합니다.


ads_management
business_management

요청 구문

GET https://graph.facebook.com/v9.0/{ig-user-id}/content_publishing_limit
  ?fields={fields}
  &since={since}
  &access_token={access-token}

쿼리 문자열 매개변수

자리 표시자 값 설명

{access-token}
필수
문자열

앱 사용자의 사용자 액세스 토큰입니다.

{fields}
쉼표로 구분된 리스트

반환하고자 하는 필드의 쉼표로 구분된 리스트입니다. 생략할 경우 기본적으로 quota_usage 필드가 반환됩니다.

{since}
Unix 타임스탬프

24시간 이내의 Unix 타임스탬프입니다.

필드

필드 값 설명

config
개체

다음의 값을 반환합니다.

  • quota_total — 앱 사용자가 quota_duration 기간(현재 50) 내에 게시할 수 있는 IG 컨테이너의 최대 개수입니다.
  • quota_duration — quota_total을 계산하는 기준 시간(초)(현재 86400초 또는 24시간)입니다.

quota_usage
쉼표로 구분된 리스트

앱 사용자가 since 쿼리 문자열 매개변수에서 지정된 시간 이후로 IG 컨테이너를 게시한 횟수입니다. since 매개변수를 생략할 경우 이 값은 앱 사용자가 최근 24시간 이내에 컨테이너를 게시한 횟수가 됩니다. fields 쿼리 문자열 매개변수가 쿼리에서 생략된 경우 기본적으로 이 필드가 반환됩니다.

요청 샘플

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914/content_publishing_limit?fields=quota_usage,rate_limit_settings&since=1609969714&access_token=IGQVJ...'

응답 샘플

{
  "data": [
    {
      "quota_usage": 2,
      "config": {
        "quota_total": 50,
        "quota_duration": 86400
      }
    }
  ]
}

업데이트

지원되지 않는 작업입니다.

삭제

지원되지 않는 작업입니다.