Method: accounts.homepage.claim

Reclama la página principal de una tienda. Para ejecutar este método, se requiere acceso de administrador.

Si la página principal ya se reclamó, se volverá a verificar la verificación (a menos que el comercio esté exento de reclamar, lo que también lo exime de la verificación) y se mostrará una respuesta correcta. Si ya no se puede verificar la propiedad, se mostrará un error, pero no se borrará el reclamo. En caso de que se produzca un error, se mostrará un mensaje de error canónico: * PERMISSION_DENIED: El usuario no tiene los permisos necesarios en esta cuenta de MC. * FAILED_PRECONDITION: - La cuenta no es una cuenta de Merchant Center. - La cuenta de MC no tiene una página principal. - El reclamo falló (en este caso, el mensaje de error contendrá más detalles).

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. El nombre de la página principal que se reclamará. Formato: accounts/{account}/homepage

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "overwrite": boolean
}
Campos
overwrite

boolean

Opcional. Cuando se establece en true, esta opción quita cualquier reclamo existente en el sitio web solicitado y lo reemplaza por un reclamo de la cuenta que realiza la solicitud.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Homepage.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.