Puedes usar el recurso Product para ver el estado detallado de tu
de Shopping inteligentes.
Con Content API, puedes recuperar el estado del producto llamando al
ProductStatuses.get. Con la API de Merchant Center, puedes recuperar el producto
recuperando el recurso Accounts.Products.
Tienes la responsabilidad de cumplir con las Políticas de Shopping anuncios y gratis de fichas. Anuncios de Shopping se reserva el derecho de aplicar estas políticas y responder adecuadamente si encontrar contenido o comportamientos que infrinjan estas políticas.
Requisitos
Para ver los estados de los productos, debes hacer lo siguiente:
- Inscribe tu cuenta en un destino.
- Proporciona un código de país válido en una de las siguientes opciones:
- El campo
feedLabel - El campo
shipping - A nivel del feed.
- La configuración de envío de tu cuenta.
- El campo
Obtén el estado de un producto
Recupera el recurso Accounts.Products para ver el estado de un producto.
A continuación, se muestra una solicitud de GET de muestra:
GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}
Todas las respuestas de products.get incluyen los siguientes campos:
creationDate: Es la fecha en la que se creó el producto.lastUpdateDate: Indica la última vez que se actualizó el producto.googleExpirationDate: Es la fecha en la que vence el producto.destinationStatuses: Son los destinos previstos del producto.itemLevelIssues: Una lista de todos los problemas asociados con el producto.
Solo verás el campo itemLevelIssues en la respuesta si el producto tiene
problemas a nivel del artículo en el momento de realizar la solicitud.
Este es un ejemplo de respuesta 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"
}
Enumera todos los estados de productos
Usa products.list para ver todos tus productos y sus estados.
Puedes usar los siguientes parámetros para definir mejor tu consulta:
pageToken: Se usa para obtener páginas de resultados subsiguientes. Cada página tiene unnextPageTokenque puedes usar para ir a la siguiente página de la secuencia.maxResults: Es la cantidad máxima de resultados por página.
A continuación, se muestra una solicitud de list de muestra con parámetros de consulta opcionales:
GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9
Este es un ejemplo de respuesta 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"
}
]
}
Es seguro probar la llamada a productstatuses.list en producción porque no
realizar cambios en tus datos.
Problemas a nivel del artículo
Cada problema a nivel del artículo incluye los siguientes campos:
code: Es el código de error del problema.severity: La gravedad del problema.resolution: Informa si el comercio puede resolver el problema.attribute: Es el nombre del atributo afectado.reportingContext: Es el contexto de denuncia al que se aplica el problema.description: Es la descripción del problema.detail: Brinda más información sobre el problema.documentation: Es la URL de la documentación sobre el problema.applicableCountries: Indica en qué países el problema afecta el producto.