Use o recurso Product para visualizar o status detalhado do seu
produtos do Shopping.
Com a API Content, é possível recuperar o status do produto chamando o
ProductStatuses.get. Com a API Merchant, é possível recuperar o produto
o status recuperando o recurso Accounts.Products.
Você é responsável por estar em conformidade com a Política de anúncios e sem custo financeiro de fichas de empresas. Anúncios do Shopping reserva o direito de aplicar essas políticas e responder adequadamente se encontrar conteúdo ou comportamento que viola essas políticas.
Requisitos
Para conferir os status dos produtos, faça o seguinte:
- Registre sua conta em um destino.
- Forneça um código de país válido em uma das seguintes opções:
- O campo
feedLabel. - O campo
shipping. - No nível do feed.
- As configurações de frete da sua conta.
- O campo
Conferir o status de um produto
Recupere o recurso Accounts.Products para conferir o status de um produto.
Confira um exemplo de solicitação GET:
GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}
Todas as respostas de products.get incluem os seguintes campos:
creationDate: a data em que o produto foi criado.lastUpdateDate: a última vez em que o produto foi atualizado.googleExpirationDate: a data em que o produto expira.destinationStatuses: os destinos pretendidos do produto.itemLevelIssues: uma lista de todos os problemas associados ao produto.
Você só verá o campo itemLevelIssues na resposta se o produto tiver
problemas no nível do item no momento da sua solicitação.
Confira um exemplo de resposta JSON:
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "288000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
Listar todos os status dos produtos
Use products.list para conferir todos os seus produtos e os status deles.
Você pode usar os seguintes parâmetros para refinar sua consulta:
pageToken: usado para receber as páginas de resultados subsequentes. Toda página tem umnextPageToken, que pode ser usado para acessar a próxima página na sequência.maxResults: o número máximo de resultados por página.
Veja um exemplo de solicitação list com parâmetros de consulta opcionais:
GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9
Confira um exemplo de resposta JSON:
{
"nextPageToken": "632fd090c95712c6",
"products": [
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/10355371287",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "28800000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
]
}
É seguro testar a chamada productstatuses.list na produção porque ela não
fazer alterações nos dados.
Problemas no nível do item
Cada problema no nível do item inclui os seguintes campos:
code: o código de erro do problema.severity: a gravidade do problema.resolution: informa se o comerciante pode resolver o problema.attribute: o nome do atributo afetado.reportingContext: o contexto do relatório em que o problema se aplica.description: a descrição do problema.detail: dá mais informações sobre o problema.documentation: o URL da documentação sobre o problema.applicableCountries: indica em quais países o problema afeta o produto.