Esta página explica como criar uma conta do Merchant Center e fazer upload de um produto de exemplo usando a API Merchant.
Antes de começar
Ative a API Merchant no projeto do Google Cloud.
Criar uma conta
Para usar a API Merchant, você precisa ter uma conta do Merchant Center. Para criar uma conta do Merchant Center, consulte Primeiros passos do Google Merchant Center.
Conferir o ID da sua conta
Você pode extrair o ID da conta usando o
método
accounts.list.
Use o APIs Explorer do Google para executar solicitações da API Merchant. O APIs Explorer usa o OAuth 2.0 do Google para autenticação. Antes de executar as solicitações, marque a caixa de seleção Google OAuth 2.0.
Para fazer a autenticação usando o OAuth 2.0, você precisa fazer login na sua Conta do Google e no APIs Explorer. Você também precisa permitir que o APIs Explorer gerencie suas informações de produtos e contas.
A solicitação a seguir mostra como recuperar o ID da sua conta:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
Depois que a solicitação for executada, você vai receber a seguinte resposta:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
Copie o {ACCOUNT_ID}, porque você vai precisar dele para executar outras solicitações.
Criar uma fonte de dados de produtos principal
Para inserir um produto, você precisa de uma fonte de dados de produtos principal. A solicitação a seguir mostra como criar uma fonte de dados que pode ser usada para inserir um produto na sua conta:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1
{
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
Substitua {ACCOUNT_ID} pelo ID da conta do Merchant Center que você criou.
Depois que essa solicitação for executada, você vai receber a seguinte resposta:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
Copie o valor do campo name, porque você vai precisar dele para inserir um
produto.
A fonte de dados criada leva alguns minutos para ficar disponível para a inserção de produtos.
É possível conferir essa fonte de dados na interface do Merchant Center. Para mais informações, consulte Como encontrar a guia "Fontes de dados".
Inserir um produto
Para inserir um produto de amostra na sua conta, execute a seguinte solicitação:
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1
{
"channel": "ONLINE",
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"attributes": {
"gender": "Male",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
Substitua {DATASOURCE_NAME} pelo valor que você copiou anteriormente.
Depois que essa solicitação for executada, você vai receber a seguinte resposta:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
"channel": "ONLINE",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"attributes": {
"brand": "New brand",
"gender": "Male"
}
}
O ID do produto recém-criado é online~en~US~tshirt-123. Você
pode usar o método
accounts.products.get
para extrair detalhes sobre esse produto. Também é possível usar a interface do Merchant
Center para conferir esse
produto.