Method: accounts.homepage.claim

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

Wenn die Startseite bereits beansprucht wurde, wird die Bestätigung noch einmal überprüft (es sei denn, der Händler ist von der Beanspruchung ausgenommen, was ebenfalls von der Überprüfung ausgenommen ist) und es wird eine erfolgreiche Antwort zurückgegeben. Wenn die Inhaberschaft nicht mehr bestätigt werden kann, wird ein Fehler zurückgegeben, der Anspruch wird jedoch nicht gelöscht. 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; - MC-Konto hat keine Startseite; - Beanspruchen fehlgeschlagen (in diesem Fall enthält die Fehlermeldung weitere Informationen).

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 muss leer sein.

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.