IG 用戶內容發佈限制

代表 IG 用戶的現有內容發佈使用量。

建立

不支援執行此作業。

讀取

GET /{ig-user-id}/content_publishing_limit

取得指定時段期間內 IG 用戶已發佈的次數和 IG 容器。如需完整的發佈步驟，請參閱內容發佈指南。

必備條件

類型條件

類型	條件
存取權杖	用戶
權限	`instagram_basic` `instagram_content_publish` `pages_read_engagement` 如果應用程式用戶是透過連結至目標 IG 用戶之粉絲專頁的企業管理平台獲得角色，您還需要下列其中一項： `ads_management` `business_management`

存取權杖

用戶

權限

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` 查詢字串參數，預設將傳回此欄位。

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
      }
    }
  ]
}

更新

不支援執行此作業。

刪除

不支援執行此作業。