Method: accounts.homepage.claim

Revendique la page d'accueil d'un magasin. L'exécution de cette méthode nécessite un accès administrateur.

Si la page d'accueil est déjà revendiquée, la validation sera revérifiée (sauf si le marchand est dispensé de la revendication, ce qui l'exempte également de la validation) et une réponse positive sera renvoyée. Si la propriété ne peut plus être validée, une erreur est renvoyée, mais la revendication n'est pas supprimée. En cas d'échec, un message d'erreur canonique est renvoyé: * PERMISSION_DENIED: l'utilisateur ne dispose pas des autorisations nécessaires sur ce compte MC ; * FAILED_PRECONDITION: - Le compte n'est pas un compte Merchant Center ; - Le compte MC n'a pas de page d'accueil ; - La revendication a échoué (dans ce cas, le message d'erreur contient plus de détails).

Requête HTTP

POST https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*/homepage}:claim

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de la page d'accueil à revendiquer. Format : accounts/{account}/homepage

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "overwrite": boolean
}
Champs
overwrite

boolean

Facultatif. Lorsque cette option est définie sur true, elle supprime toute revendication existante sur le site Web demandé et la remplace par une revendication du compte à l'origine de la demande.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Homepage.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la présentation d'OAuth 2.0.