Method: accounts.homepage.claim

Rivendica la home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Se la home page è già stata rivendicata, la verifica verrà riesaminata (a meno che il commerciante non sia esente dalla rivendicazione, il che comporta anche l'esenzione dalla verifica) e verrà restituita una risposta positiva. Se la proprietà non può più essere verificata, verrà restituito un errore, ma la rivendicazione non verrà cancellata. In caso di errore, verrà restituito un messaggio di errore canonico: * PERMISSION_DENIED: l'utente non dispone delle autorizzazioni necessarie per questo account MC; * FAILED_PRECONDITION: - L'account non è un account Merchant Center; - L'account MC non ha una home page; - il reclamo non è andato a buon fine (in questo caso il messaggio di errore conterrà ulteriori dettagli).

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome della home page da rivendicare. Formato: accounts/{account}/homepage

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "overwrite": boolean
}
Campi
overwrite

boolean

Facoltativo. Se impostata su true, questa opzione rimuove qualsiasi rivendicazione esistente sul sito web richiesto e la sostituisce con una rivendicazione dell'account che effettua la richiesta.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Homepage.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.