クリエイティブアセットタグ

クリエイティブアセット(画像や動画)にタグを割り当てることができます。

クリエイティブアセットタグの追加

{business-image-id}/creative_asset_tagsまたは{business-video-id}/creative_asset_tagsエンドポイントにPOSTリクエストを実行して、クリエイティブにクリエイティブアセットタグを追加することができます。呼び出しにパラメーターbusiness-idとtag_nameを含めてください。

画像の場合

リクエストの例

curl -i -X POST \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_IMAGE_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&tag_name=<TAG_NAME>&access_token=<ACCESS_TOKEN>"

成功した場合の応答の例

{
"success": true
}

動画の場合

リクエストの例

curl -i -X POST \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_VIDEO_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&tag_name=<TAG_NAME>&access_token=<ACCESS_TOKEN>"

成功した場合の応答の例

{
"success": true
}

クリエイティブアセットタグの削除

{business-image-id}/creative_asset_tagsまたは{business-video-id}/creative_asset_tagsエンドポイントにDELETEリクエストを送信して、ビジネス画像とビジネス動画からタグを削除します。パラメーターbusiness-idとtag_nameを含めます。

画像の場合

リクエストの例

curl -i -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_IMAGE_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&tag_name=<TAG_NAME>&access_token=<ACCESS_TOKEN>"

成功した場合の応答の例

{
"success": true
}

動画の場合

リクエストの例

curl -i -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_VIDEO_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&tag_name=<TAG_NAME>&access_token=<ACCESS_TOKEN>"

成功した場合の応答の例

{
"success": true
}

アセットのクリエイティブアセットタグの取得

特定の画像や動画に関連付けられたタグを確認するには、{business_image_id}/creative_asset_tagsまたは{business_video_id}/creative_asset_tagsエッジにGETリクエストを送信します。呼び出しでbusiness_id={business_id}を指定します。

画像の場合

リクエストの例

curl -i -X GET \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_IMAGE_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

成功した場合の応答の例

{
  "data": [
    {
      "name": "<TAG_NAME>"
    },
    {
      "name": "<TAG_NAME>"
    },
    {
      "name": "<TAG_NAME>"
    },
    {
      "name": "<TAG_NAME>"
    },
    {
      "name": "<TAG_NAME>"
    }
  ]
}

動画の場合

リクエストの例

curl -i -X GET \
"https://graph.facebook.com/v<API_VERSION>/<BUSINESS_VIDEO_ID>/creative_asset_tags?business_id=<BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

成功した場合の応答の例

{
  "data": [
    {
      "name": "<TAG_NAME>"
    }
  ]
}

ビジネスのクリエイティブアセットタグの取得

ビジネス内の既存のすべてのクリエイティブアセットタグを確認するには、{business_id}/creative_asset_tagsエッジにGETリクエストを送信します。

リクエストの例

curl -i -X GET \
"https://graph.facebook.com/v5.0/<BUSINESS_ID>/creative_asset_tags?access_token=<ACCESS_TOKEN>"

成功した場合の応答の例

{
  "data": [
    {
    "name": "<TAG_NAME>"
    },
    {
    "name": "<TAG_NAME>"
    },
    {
    "name": "<TAG_NAME>"
    },
    {
    "name": "<TAG_NAME>"
    },
    {
    "name": "<TAG_NAME>"
    }
  ]
}

エンドポイント

POST

READ

DELETE