Instagram Graph API

Instagram 用戶內容發佈限制

代表 Instagram 用戶目前的內容發佈功能使用情況。

建立

不支援這項操作。

讀取

GET /{ig-user-id}/content_publishing_limit

獲取 Instagram 用戶在特定時段內發佈 Instagram 容器的次數。請參閱內容發佈指南，了解完整的發佈步驟。

必要條件

類型必要條件

存取憑證

用戶

權限

instagram_basic
instagram_content_publish
pages_read_engagement


如果應用程式用戶透過企業管理平台取得與目標 Instagram 用戶關聯的專頁角色，您還需要以下其中一項權限：


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 時戳

Unix 時戳不得超過 24 小時。

欄位

欄位 值的說明

config
物件

傳回這些值：

  • quota_total：應用程式用戶在 quota_duration 時段內可發佈的 Instagram 容器數量上限，目前為 50。
  • quota_duration：用來計算 quota_total 的時間範圍，以秒為單位；目前為 86400 秒，即 24 小時。

quota_usage
逗號分隔清單

由 since 查詢字串參數中指定的時間起計，應用程式用戶發佈 Instagram 容器的次數。如果不指定 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
      }
    }
  ]
}

更新

不支援這項操作。

刪除

不支援這項操作。