POST /{ig-media-id}/product_tags
既存のIGメディアの商品タグを作成または更新します。
x
とy
の値が、新しい値に更新されます(新しいタグは追加されません)。タイプ | 要件 |
---|---|
アプリユーザーには、IGユーザーのInstagramショップを所有するビジネスマネージャの管理者権限がなければなりません。 | |
IGメディアを所有するIGユーザーには、承認済みのInstagramショップと、商品が含まれている商品カタログがなければなりません。 | |
ターゲットのIGユーザーに接続されたページの役割がビジネスマネージャを介してアプリユーザーに付与されている場合は、次のうちのいずれか1つも必要です。 |
POST https://graph.facebook.com/{api-version}/{ig-media-id}/product_tags ?updated_tags={updated-tags} &access_token={access-token}
プレースホルダー | 値 |
---|---|
| APIバージョン。 |
| 必須。IGメディアID。 |
キー | プレースホルダー | 値 |
---|---|---|
|
| 必須。アプリユーザーのユーザーアクセストークン。 |
|
| 必須。画像と動画にのみ適用。画像または動画にどの商品タグを付けるかを指定するオブジェクトの配列(最大5。タグと商品IDは一意でなければなりません)。オブジェクトごとに以下の情報が必要です。
例
|
成否を示すオブジェクト。
{ "success": {success} }
プロパティ | 値 |
---|---|
| IGメディアの商品タグの更新が可能な場合は |
curl -i -X POST \
"https://graph.facebook.com/v19.0
/90010778325754/product_tags?updated_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20x%3A%200.5%2C%0A%20%20%20%20y%3A%200.8%0A%20%20%7D%0A%5D&access_token=EAAOc..."
参考までに、以下にHTMLデコードされたPOSTペイロード文字列を示します。
https://graph.facebook.com/v19.0
/90010778325754/product_tags?updated_tags=[ { product_id:'3859448974125379', x: 0.5, y: 0.8 } ]&access_token=EAAOc...
{ "success": true }
GET /{ig-media-id}/product_tags
IGメディアの商品タグのコレクションを取得します。商品タグ付けの手順について詳しくは、商品タグ付けガイドをご覧ください。
タイプ | 要件 |
---|---|
アプリユーザーには、IGユーザーのInstagramショップを所有するビジネスマネージャの管理者権限がなければなりません。 | |
IGメディアを所有するIGユーザーには、承認済みのInstagramショップと、商品が含まれている商品カタログがなければなりません。 | |
ターゲットのIGユーザーに接続されたページの役割がビジネスマネージャを介してアプリユーザーに付与されている場合は、次のうちのいずれか1つも必要です。 |
GET https://graph.facebook.com/{api-version}/{ig-media-id}/product_tags ?access_token={access-token}
プレースホルダー | 値 |
---|---|
| APIバージョン。 |
| 必須。IGメディアID。 |
キー | プレースホルダー | 値 |
---|---|---|
|
| 必須。アプリユーザーのユーザーアクセストークン。 |
IGメディアの商品タグの配列を含むJSON形式のオブジェクト。応答には、以下の商品タグフィールドが含まれることがあります。
{ "data": [ { "product_id": {product-id}, "merchant_id": {merchant-id}, "name": "{name}", "price_string": "{price-string}", "image_url": "{image-url}", "review_status": "{review-status}", "is_checkout": {is-checkout}, "stripped_price_string": "{stripped-price-string}", "string_sale_price_string": "{string-sale-price-string}", "x": {x}, "y": {y} } ] }
プロパティ | 値 |
---|---|
| 商品ID。 |
| 販売者ID。 |
| 商品名。 |
| 価格文字列。 |
| 商品画像のURL。 |
| 商品レビューのステータス。値は次のいずれかです。
|
|
|
| 商品の短縮価格文字列(スペースに制約がある場合の価格。 |
| 商品の販売価格。 |
| メディア画像の左境界からの距離をパーセントで示す浮動小数点数。 |
| メディア画像の上境界からの距離をパーセントで示す浮動小数点数。 |
curl -i -X GET \
"https://graph.facebook.com/v19.0
/90010778325754/product_tags?access_token=EAAOc..."
{ "data": [ { "product_id": 3231775643511089, "merchant_id": 90010177253934, "name": "Gummy Bears", "price_string": "$3.50", "image_url": "https://scont...", "review_status": "approved", "is_checkout": true, "stripped_price_string": "$3.50", "stripped_sale_price_string": "$3", "x": 0.5, "y": 0.80000001192093 } ] }
作成をご覧ください。
DELETE /{ig-media-id}/product_tags
既存のIGメディアの商品タグを削除します。
タイプ | 要件 |
---|---|
アプリユーザーには、IGユーザーのInstagramショップを所有するビジネスマネージャの管理者権限がなければなりません。 | |
IGメディアを所有するIGユーザーには、承認済みのInstagramショップと、商品が含まれている商品カタログがなければなりません。 | |
ターゲットのIGユーザーに接続されたページの役割がビジネスマネージャを介してアプリユーザーに付与されている場合は、次のうちのいずれか1つも必要です。 |
DELETE https://graph.facebook.com/{api-version}/{ig-media-id}/product_tags ?deleted_tags={deleted-tags} &access_token={access-token}
プレースホルダー | 値 |
---|---|
| APIバージョン。 |
| 必須。IGメディアID。 |
キー | プレースホルダー | 値 |
---|---|---|
|
| 必須。アプリユーザーのユーザーアクセストークン。 |
|
| 必須。削除する各商品タグに関する以下の情報を含む配列
|
成否を示すオブジェクト。
{ "success": {success} }
プロパティ | 値 |
---|---|
| IGメディアの指定した商品タグの削除が可能な場合は |
curl -i -X DELETE \
"https://graph.facebook.com/v19.0
/90010778325754/product_tags?deleted_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20merchant_id%3A'90010177253934'%0A%20%20%7D%0A%5D&access_token=EAAOc..."
参考までに、以下にHTMLデコードされたPOSTペイロード文字列を示します。
https://graph.facebook.com/v12.0/90010778325754/product_tags?deleted_tags=[ { product_id:'3859448974125379', merchant_id:'90010177253934' } ]&access_token=EAAOc...
{ "success": true }