Method: accounts.homepage.claim

zgłaszanie praw do strony głównej sklepu, Wykonywanie tej metody wymaga dostępu administracyjnego.

Jeśli strona główna została już zgłoszona, nastąpi ponowna weryfikacja (chyba że sprzedawca jest zwolniony z obowiązku zgłaszania, co zwalnia też z weryfikacji) i zwrócona zostanie odpowiedź z pozytywnym wynikiem. Jeśli nie można już zweryfikować własności, zwróci błąd, ale nie wyczyści roszczenia. W przypadku niepowodzenia zwracany jest kanoniczny komunikat o błędzie: * PERMISSION_DENIED: użytkownik nie ma wymaganych uprawnień na tym koncie MC; * FAILED_PRECONDITION: – konto nie jest kontem Merchant Center; – konto MC nie ma strony głównej; – zgłoszenie nie powiodło się (w tym przypadku komunikat o błędzie będzie zawierać więcej szczegółów).

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa strony głównej, której dotyczy roszczenie. Format: accounts/{account}/homepage

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "overwrite": boolean
}
Pola
overwrite

boolean

Opcjonalnie: Gdy ta opcja jest ustawiona na wartość true, usuwa ona wszystkie istniejące roszczenia dotyczące żądanej witryny i zastępuje je roszczeniem z konta, które wysłało żądanie.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Homepage.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.