Method: accounts.homepage.claim

Beansprucht die Startseite eines Geschäfts. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Wenn für die Startseite bereits ein Anspruch erhoben wurde, wird die Bestätigung noch einmal überprüft (es sei denn, der Händler ist von der Anspruchserhebung ausgenommen, was auch die Bestätigung ausschließt) und eine erfolgreiche Antwort zurückgegeben. Wenn die Inhaberschaft nicht mehr bestätigt werden kann, wird ein Fehler zurückgegeben, der Anspruch wird jedoch nicht aufgehoben. Bei einem Fehler wird eine kanonische Fehlermeldung zurückgegeben: * PERMISSION_DENIED: Der Nutzer hat nicht die erforderlichen Berechtigungen für dieses Merchant Center-Konto. * FAILED_PRECONDITION: – Das Konto ist kein Merchant Center-Konto. – Das Merchant Center-Konto hat keine Startseite. – Die Anspruchserhebung ist fehlgeschlagen (in diesem Fall enthält die Fehlermeldung weitere Details).

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Name der Startseite, für die der Anspruch erhoben werden soll. Format: accounts/{account}/homepage

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "overwrite": boolean
}
Felder
overwrite

boolean

Optional. Wenn diese Option auf true gesetzt ist, werden alle vorhandenen Ansprüche für die angeforderte Website entfernt und durch einen Anspruch aus dem Konto ersetzt, das die Anfrage stellt.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Homepage.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.