Catalogue

Gérez les catalogues des publicités de catalogue Advantage+ à l’aide de Business Manager. Une fois que vous avez créé un catalogue pour une entreprise, vous pouvez configurer des flux de produits et des ensembles de produits. Voir Catalogue : documentation de référence.

Afficher les catalogues appartenant à une entreprise

Pour afficher tous les catalogues qui appartiennent à votre entreprise, utilisez l’appel GET suivant :

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_product_catalogs"

Cet appel renvoie la liste des catalogues qui appartiennent à un compte Business Manager.

Pour afficher tous les catalogues pour lesquels votre entreprise fait office d’agence, utilisez l’appel GET suivant :

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_product_catalogs"

Cet appel renvoie la liste des catalogues qui appartiennent aux client·es d’un compte Business Manager.

Autorisations d’un catalogue

Pour mettre à jour les articles d’un catalogue, les utilisateur·ices (y compris les utilisateur·ices système et les admins système) ont besoin d’autorisations. Les tâches possibles sur un catalogue sont MANAGE et ADVERTISE.

Pour affecter les tâches MANAGE et ADVERTISE d’un catalogue à un·e utilisateur·ice dans le cadre d’une entreprise :

curl \
  -X POST \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "business=BUSINESS_ID" \
  -F "tasks=['ADVERTISE', 'MANAGE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/assigned_users"

Pour affecter la tâche ADVERTISE d’un catalogue à un·e utilisateur·ice dans le cadre d’une entreprise :

curl \
  -X POST \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "business=BUSINESS_ID" \
  -F "tasks=['ADVERTISE']" \
  -F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/assigned_users"

Pour obtenir l’identifiant utilisateur·ice :

curl \-X GET \
  -F "access_token=<ACCESS_TOKEN>" \ 
"https://graph.facebook.com/<API_VERSION>/me"

Pour retirer à un·e utilisateur·ice·dans le cadre d’une entreprise les autorisations associées à un catalogue :

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/assigned_users"

Pour afficher les catalogues sur lesquels un·e utilisateur·ice professionnel·le, un·e utilisateur·ice système ou un·e utilisateur·ice en attente disposent d’autorisations, effectuez une requête GET :

curl -G \-d "access_token=ACCESS_TOKEN" \"https://graph.facebook.com/<API_VERSION>/BUSINESS_SCOPED_USER_ID/assigned_product_catalogs"
curl -G \-d "access_token=ACCESS_TOKEN" \"https://graph.facebook.com/<API_VERSION>/SYSTEM_USER_ID/assigned_product_catalogs"
curl -G \-d "access_token=ACCESS_TOKEN" \"https://graph.facebook.com/<API_VERSION>/PENDING_USER_ID/assigned_product_catalogs"

Pour afficher les autorisations associées à un catalogue dans le cadre d’une entreprise :

curl \
  -X GET \
  "https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/assigned_users?business=BUSINESS_ID&access_token=ACCESS_TOKEN"