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 |
Erforderlich. Der Name der Startseite, auf die Anspruch erhoben werden soll. Format: |
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.