Pages

Les entreprises peuvent revendiquer les Pages qui leur appartiennent. Cela permet aux admins d’affecter facilement des utilisateur·ices aux Pages auxquelles elles ou ils doivent accéder.

Revendiquer des Pages

Les entreprises peuvent revendiquer la propriété d’une page qui leur appartient, ce qui leur permet de gérer tous ses aspects, y compris la suppression de toute agence ou autre entreprise ayant obtenu l’accès. Sinon, les entreprises peuvent également demander l’accès de l’agence à une page, ce qui leur permettra de diffuser des publicités sur celle-ci via les comptes publicitaires auxquels elles ont accès.

Revendiquer des Pages en tant que propriétaire

Afin de revendiquer une Page pour votre entreprise en tant que propriétaire (OWNER), vous avez besoin de l’ID de la Page et de l’ID de l’entreprise. Envoyez ensuite une requête POST :

La personne à l’origine de la demande doit disposer des éléments suivants :

• Autorisation d’administrer la Page
• Autorisation pour l’entreprise propriétaire ou approbation de la demande par le propriétaire de l’entreprise propriétaire

Cette requête exige d’utiliser le token d’accès d’un·e utilisateur·ice admin ou système admin de votre entreprise. Si l’utilisateur·ice qui exécute l’appel est admin ou MANAGER de la Page depuis plus de 7 jours, la Page appartient immédiatement à l’entreprise. Facebook renvoie access_status, qui est défini sur CONFIRMED. Si l’utilisateur·ice est admin ou MANAGER de la Page depuis 7 jours ou moins, nous n’approuvons pas automatiquement la requête d’API.

L’appel de revendication en tant qu’OWNER échoue si l’utilisateur·ice ne dispose pas des autorisations appropriées pour la Page. La demande n’a pas besoin d’être approuvée par les admins de la Page, contrairement aux demandes de revendication d’un compte publicitaire.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Revendiquer des Pages en tant qu’agence

Afin de revendiquer une Page pour votre entreprise en tant qu’AGENCY, vous avez besoin de l’ID de la Page. Envoyez ensuite une requête POST :

Si la personne à l’origine de la demande dispose de l’autorisation d’administrer la Page, la requête sera automatiquement approuvée. Dans le cas contraire, l’admin de la Page devra approuver la requête.

L’agence ne peut pas repartager la Page à une autre entreprise.

L’agence peut commencer à diffuser des publicités sur la Page (par le biais des comptes publicitaires auxquels ils ont accès) immédiatement.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Si vous utilisez AGENCY :

• Vous devez indiquer le paramètre permitted_tasks.
• Une entreprise doit posséder la Page.
• Le token d’accès doit avoir les autorisations pages_manage_metadata et pages_show_list.

Si vous envoyez une demande de revendication en tant qu’AGENCY, mais que vous ne disposez pas des autorisations appropriées pour la Page, la réponse est PENDING. L’admin de cette Page peut se connecter et accorder l’accès, le refuser ou signaler la revendication comme indésirable. Si une entreprise signale comme indésirable un nombre excessif de demandes d’accès à la Page, nous bloquons le compte Business Manager.

Pour afficher toutes les Pages de client·e auxquelles vous avez demandé à accéder, mais qui sont en attente d’approbation, exécutez l’appel GET suivant. Vous avez besoin du token d’accès de l’utilisateur·ice système admin :

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

Afficher les Pages appartenant à une entreprise ou les Pages appartenant aux client·es de l’entreprise

Pour afficher toutes les Pages 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_pages"

Pour afficher toutes les Pages pour lesquelles 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_pages"

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

Ajouter des Pages de manière groupée

L’UI de Business Manager permet d’ajouter des pages individuelles. Pour ajouter des Pages de façon groupée à un compte Business Manager, exécutez les appels POST suivants :

curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'batch=[
  {
    "method":"POST",
    "name":"test1",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_1>"
  }, 
  {
    "method":"POST",
    "name":"test2",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_2>"
  }, 
  {
    "method":"POST",
    "name":"test3",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_3>"
  }, 
]' \
"https://graph.facebook.com/<API_VERSION>"

Où :

• <ACCESS_TOKEN> est un token d’accès incluant l’autorisation business_management.
• <BUSINESS_ID> est l’ID du compte Business Manager sur lequel les pages doivent être revendiquées.
• <PAGE_ID_n> correspond aux ID des Pages à revendiquer.

Supprimer des Pages

Pour supprimer une Page du compte Business Manager, exécutez l’appel DELETE suivant :

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

Ajouter des utilisateur·ices à des Pages

Une fois que votre entreprise dispose d’une Page, vous pouvez attribuer des tâches à des utilisateur·ices. Voici la liste des tâches possibles :

Réalisez les actions suivantes :

• page_id : ID de la Page
• user_id : identifiant de l’utilisateur·ice à ajouter
• Tâches à attribuer

Exécutez l’appel POST suivant pour ajouter un·e utilisateur·ice et lui attribuer les tâches ['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE'] :

L’ID d’entreprise doit appartenir à l’entreprise propriétaire de la Page

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

Modifier l’accès à des Pages

Pour modifier les tâches d’un·e utilisateur·ice existant·e, exécutez le même appel POST que lors de l’ajout d’un·e utilisateur·ice :

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

Visualiser les autorisations liées à une Page

Pour visualiser les Pages pour lesquelles des autorisations ont été accordées, exécutez l’appel GET suivant :

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

Pour connaître les autorisations accordées pour une Page, exécutez l’appel GET suivant :

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users?business=<BUSINESS_ID>"

Supprimer l’accès à une Page

Pour supprimer une Page de Business Manager, vous devez également supprimer les admins de cette Page dans votre entreprise.

Pour qu’un·e utilisateur·ice ne puisse plus accéder à une Page qui vous appartient, vous avez besoin des éléments suivants :

• page_id : ID de la Page
• user_id : identifiant de l’utilisateur·ice à supprimer

L’appel DELETE se présente comme suit :

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