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. Im Falle eines Fehlers wird eine kanonische Fehlermeldung zurückgegeben: * PERMISSION_DENIED: Nutzer hat nicht die erforderlichen Berechtigungen für dieses MC-Konto; * FAILED_PRECONDITION: – Das Konto ist kein Merchant Center-Konto. - Das Merchant Center-Konto hat keine Startseite. – Beanspruchen 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, auf die 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 auf die angeforderte Website entfernt und durch einen Anspruch des Kontos ersetzt, über das der Antrag gestellt wurde.

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 Übersicht über OAuth 2.0.