Migrar as configurações da página inicial

A API Merchant apresenta um recurso dedicado Homepage. Esse recurso oferece novos métodos para gerenciar a reivindicação da sua página inicial, com recursos que vão além da API Content for Shopping clássica.

Para acessar os recursos da sua loja on-line, você precisa seguir duas etapas: primeiro, verificar a propriedade e, depois, reivindicar o site para sua conta. Para concluir a etapa final, use o accounts.homepage.claim.

principais diferenças

A API Merchant faz várias mudanças relacionadas à página inicial em comparação com a API Content for Shopping:

• Recurso dedicado: a API Merchant oferece um recurso Homepage distinto (accounts.homepage) para todas as operações relacionadas à página inicial. Na API Content for Shopping, você usava accounts.claimwebsite para realizar a ação de reivindicação, o URL da página inicial (website_url) fazia parte do recurso Account e o status da reivindicação (website_claimed) fazia parte do recurso AccountStatus.
• Métodos granulares: a API Merchant oferece métodos específicos para:
  • Recuperar detalhes da página inicial: accounts.homepage.getHomepage
  • Atualize o URI da página inicial: accounts.homepage.updateHomepage
  • Reivindique a página inicial: accounts.homepage.claim
  • Remover a reivindicação da página inicial: accounts.homepage.unclaim A API Content for Shopping usou accounts.claimwebsite para a ação de reivindicação, accounts.update para definir o URL (e remover a reivindicação definindo um URL vazio) e accounts.get/accountstatuses.get para recuperar o URL e o status da reivindicação, respectivamente.
• Informações centralizadas: o recurso Homepage da API Merchant contém o uri (URL da página inicial) e o status de claimed diretamente. Todos os métodos que operam no recurso Homepage retornam esse recurso, fornecendo feedback imediato sobre o estado atual. Na API Content for Shopping, accounts.claimwebsite não retornava o status atualizado. Era necessário fazer chamadas separadas.
• Renúncia explícita: na API Content for Shopping, a renúncia geralmente era feita atualizando o Account.website_url para uma string vazia. A API Merchant oferece um método homepage.unclaim dedicado.
• Substituir reivindicação: as duas APIs aceitam um parâmetro overwrite durante o processo de reivindicação para assumir uma reivindicação de outra conta se a propriedade puder ser verificada.

Solicitações

A API Merchant usa endpoints RESTful distintos para gerenciar diferentes aspectos da página inicial.

Descrição da solicitação	API Content for Shopping	API Merchant
Acessar os detalhes da página inicial	accounts.get (para ler Account.website_url), accountstatuses.get (para ler AccountStatus.website_claimed)	GET /accounts/v1/accounts/{account}/homepage
Atualizar o URI da página inicial	accounts.update (configuração Account.website_url)	PATCH /accounts/v1/accounts/{account}/homepage
Reivindicar ou verificar novamente a página inicial	POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite (ação realizada no conjunto Account.website_url usando accounts.update)	POST /accounts/v1/accounts/{account}/homepage:claim
Renunciar à página inicial	accounts.update (definindo Account.website_url como uma string vazia)	POST /accounts/v1/accounts/{account}/homepage:unclaim

Identificadores

A identificação de recursos foi simplificada na API Merchant.

Descrição do identificador	API Content for Shopping	API Merchant
Identificador da conta para acesso a recursos	merchantId (conta avançada) e accountId (subconta) no caminho	account (parte do campo name, como accounts/{account_id}/homepage)
Identificador de recursos da página inicial	Não relevante (implícito ao recurso Account)	name: accounts/{account_id}/homepage (identifica o sub-recurso Homepage)

Métodos

O método accounts.claimwebsite da API Content for Shopping, que era focado na ação de reivindicação, agora faz parte de um conjunto mais amplo de funcionalidades no recurso Homepage da API Merchant.

Método da API Content for Shopping	Método da API Merchant	Disponibilidade e observações
accounts.claimwebsite	accounts.homepage.claim	Inicia ou verifica novamente uma reivindicação de site. Atua no uri definido anteriormente usando homepage.update. Inclui um parâmetro overwrite. Retorna o recurso Homepage com o status atual de uri e claimed.
accounts.get (para ler Account.website_url), accountstatuses.get (para ler AccountStatus.website_claimed)	accounts.homepage.getHomepage	Novo método dedicado para recuperar a página inicial atual uri e o status claimed em uma única chamada.
accounts.update (para definir Account.website_url)	accounts.homepage.updateHomepage	Novo método dedicado para definir ou mudar a página inicial uri.
accounts.update (definir Account.website_url como uma string vazia como uma solução alternativa para cancelar a reivindicação)	accounts.homepage.unclaim	Novo método dedicado para cancelar explicitamente a reivindicação de uma página inicial.

Mudanças detalhadas nos campos

A forma como as informações da página inicial são estruturadas e acessadas mudou significativamente, passando para o recurso explícito Homepage na API Merchant.

API Content for Shopping	API Merchant	Descrição
merchantId (parâmetro de caminho para accounts.claimwebsite)	name (parâmetro de caminho para métodos Homepage, formato: accounts/{account}/homepage)	A parte account da string name na API Merchant corresponde ao accountId da API Content for Shopping.
accountId (parâmetro de caminho para accounts.claimwebsite)	name (parâmetro de caminho para métodos Homepage, formato: accounts/{account}/homepage)	O identificador da conta específica cuja página inicial está sendo gerenciada.
overwrite (booleano no corpo de ContentAccountsClaimwebsiteRequest e AccountsCustomBatchRequestEntry)	ClaimHomepageRequest.overwrite (booleano no corpo da solicitação homepage.claim)	Opcional. Se for true, tenta reivindicar o site, o que pode remover uma reivindicação de outra conta se a propriedade puder ser verificada pela conta solicitante.
Account.website_url (campo no recurso Account, definido usando accounts.update, lido usando accounts.get)	Homepage.uri (campo no recurso Homepage)	O URI (URL) da página inicial da loja. Na API Merchant, esse é um campo explícito no recurso Homepage. Ele é definido usando accounts.homepage.updateHomepage e retornado por todos os métodos Homepage.
AccountStatus.website_claimed (campo no recurso AccountStatus, lido usando accountstatuses.get)	Homepage.claimed (campo booleano output_only no recurso Homepage)	Indica se o uri foi reivindicado e verificado. Esse status está disponível diretamente no recurso Homepage retornado por todos os métodos associados da API Merchant.
N/A	UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage parâmetro do corpo da solicitação)	Uma máscara de campo opcional para homepage.update que especifica quais campos (por exemplo, uri) do recurso Homepage estão sendo atualizados.