Method: accounts.homepage.claim

Zgłasza prawa do strony głównej sklepu. Wykonywanie tej metody wymaga dostępu administracyjnego.

Jeśli strona główna została już zarezerwowana, nastąpi ponowne sprawdzenie weryfikacji (chyba że sprzedawca jest zwolniony z zgłaszania praw do strony, co też jest zwolnione z weryfikacji) i zwróci prawidłową odpowiedź. Jeśli nie będzie można zweryfikować własności, spowoduje to wyświetlenie błędu, ale nie spowoduje usunięcia 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 wysyła prośbę.

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 protokołu OAuth 2.0.