Puedes usar el recurso Product para ver el estado detallado de tus productos de Shopping.
Con Content API, puedes recuperar el estado del producto llamando al método ProductStatuses.get. Con la API de Merchant, puedes recuperar el estado del producto mediante la recuperación del recurso Accounts.Products.
Eres responsable de cumplir con las políticas de anuncios de Shopping y fichas gratuitas. Los anuncios de Shopping se reservan el derecho de aplicar estas políticas y de responder de forma apropiada si encontramos contenido o comportamiento que las incumpla.
Requisitos
Para ver los estados de los productos, sigue estos pasos:
- Inscribe tu cuenta en un destino.
- Proporciona un código de país válido en uno de los siguientes vínculos:
- 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.
Esta es 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: Es 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: Es 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 la solicitud.
A continuación, se muestra 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 los productos
Usa products.list para ver todos tus productos y el estado correspondiente.
Puedes usar los siguientes parámetros para definir mejor tu consulta:
pageToken: Se usa para obtener las páginas de resultados posteriores. Cada página tiene unnextPageTokenque puedes usar para obtener 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
A continuación, se muestra 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 productstatuses.list en producción porque no
realiza ningún cambio 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: Es 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 los informes 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 al producto.