Descripción general de la API de fuentes de datos del comercio

En esta página, se muestra cómo crear y actualizar de forma programática tus fuentes de datos que te permiten insertar productos. Datos automáticos fuentes facilitan el envío tus datos de productos a Google. Las fuentes de datos automáticas se aseguran de que la información más actualizada sobre los productos relevantes de tu sitio web llegue a Google.

Content API for Shopping solo te permite crear fuentes de datos principales. Con la API de Merchant Data Sources, puedes crear los siguientes tipos de fuentes de datos:

• Fuentes principales de datos de productos
• Fuentes complementarias de datos de productos
• Fuentes de datos del inventario local
• Fuentes de datos de inventario regionales
• Fuentes de datos de promociones
• Fuentes de datos de opiniones sobre productos
• Fuentes de datos de las opiniones sobre comercios

Content API for Shopping solo te permite administrar fuentes de datos con entrada de archivos. La API de Merchant te permite administrar fuentes de datos con entradas de archivos y de la API.

Con la API de Merchant Data Sources, puedes hacer lo siguiente:

• Crea una nueva fuente de datos principal con un feedLabel y un valor contentLanguage
• Crea una fuente de datos que no tenga feedLabel ni contentLanguage conjuntos de campos seleccionados. Con este tipo de fuente de datos, puedes segmentar tus productos para varios países, ya que puedes insertar productos con diferentes combinaciones de feedLabel y contentLanguage en una sola fuente de datos.
• Crea una fuente de datos complementaria para vincularla a una fuente de datos principal existente.
• Configura un programa para una fuente de datos de archivos.
• Inscribe tu cuenta para administrar automáticamente las fuentes de datos.
• Administrar fuentes de datos de la API
• Administra la regla predeterminada de las fuentes de datos con las fuentes principales de datos de productos.
• Usa otros tipos de fuentes de datos, como las promociones.

No puedes usar la API de Merchant Center para insertar productos en una fuente de datos que contenga para productos locales y en línea. Para obtener más información sobre los canales de fuentes de datos, consulta Canales.

Requisitos previos

• Tu cuenta se debe haber migrado a feeds regionales únicos.

• Para verificar que la cuenta ya se haya migrado a la división de objetivos de datos, usa la lista de fuentes de datos o los métodos get. En caso de que no cumplas con los requisitos, recibirás el siguiente mensaje de excepción y debes comunicarte con el equipo de asistencia.

  This account is in the data sources migration process and can't be used with
  this API yet. Contact support for more info on when this account will be able
  to use the data sources endpoint.
  

Crea una fuente de datos nueva

Las fuentes de datos principales corresponden a las principales fuentes de datos de tu cuenta de Merchant Center. en el inventario de Google. Solo puedes agregar o quitar productos usando una fuente de datos principal. Si Cada producto que agregas a tu fuente de datos principal cumple con los datos de Merchant Center. y requisitos de elegibilidad, no tendrás que crear más fuentes de datos.

Para crear una nueva fuente de datos principal con un feedLabel y un contentLanguage específicos, configura los campos feedLabel y contentLanguage en la configuración específica del tipo. Para obtener más información sobre estos campos, consulta PrimaryProductDataSource.

Para obtener más información sobre cómo crear una fuente de datos, consulta el método accounts.dataSources.create.

Para ver la fuente de datos que acabas de crear, usa el método accounts.dataSources.get o accounts.dataSources.list.

Crea una nueva fuente de datos principal que te ayude a segmentar los anuncios para varios países

Para crear un nuevo feed principal que te ayude a segmentar los anuncios para varios países, configura tu fuente de datos con PrimaryProductDataSource y no establezcas los campos feedLabel y contentLanguage.

Con Content API for Shopping, solo se crea una fuente de datos de API para ti. Con la API de Merchant Data Sources, puede tener varias fuentes de datos de API, algunos de los cuales pueden estar sin los campos feedLabel y contentLanguage configurados.

Solo las fuentes de datos con entrada de API pueden no tener feedLabel ni Se configuraron contentLanguage campos. Este tipo de fuentes de datos no es compatible con archivos de datos.

Crear una fuente de datos complementaria y vincularla a la fuente de datos principal

Las fuentes de datos complementarias solo se usan para actualizar datos de productos que ya tienen existen en una o más fuentes de datos principales. Puedes tener varias fuentes de datos complementarias, y cada una puede agregar datos a cualquier cantidad de fuentes de datos principales.

Puedes usar fuentes de datos complementarias para realizar actualizaciones parciales de los datos de productos. Para ello, agrega el identificador único de la fuente de datos como un parámetro de consulta cuando realices llamadas a los métodos accounts.productInputs.insert y accounts.productInputs.delete. Solo puedes usar fuentes de datos complementarias para actualizar productos existentes.

Para crear una fuente de datos complementaria, configura tu fuente de datos usando SupplementalProductDataSource y, luego, vincúlalo actualizando defaultRule de tu fuente de datos principal.

Las fuentes de datos de archivos complementarias deben tener los elementos feedLabel y contentLanguage conjuntos de campos seleccionados. Las fuentes de datos de la API complementarias siempre deben tener los elementos feedLabel y contentLanguage campos no establecidos.

Configura una programación para tu fuente de datos de archivos

Para configurar un programa para tu feed de archivos, configura tu fuente de datos para que sea una fuente de datos de archivo con el campo FileInput y, luego, configura fetchsettings con el campo FileInput.FetchSettings.

Cómo borrar una fuente de datos

Para eliminar una fuente de datos existente de tu cuenta, utiliza la accounts.dataSources.delete .

Cómo recuperar la fuente de datos

Para recuperar un archivo configurado en la fuente de datos, usa el método accounts.dataSources.fetch. Este método realiza la recuperación de datos inmediatamente en una fuente de datos desde tu cuenta. Este método solo funciona en fuentes de datos con un conjunto de entradas de archivo.

Obtener fuente de datos

Para recuperar la configuración de fuente de datos de tu cuenta, usa el accounts.dataSources.get .

Enumerar fuentes de datos

Para ver una lista con las configuraciones de las fuentes de datos para tu cuenta, usa el accounts.dataSources.list .

Aplicar parche a la fuente de datos

Para actualizar la configuración de una fuente de datos existente, usa el accounts.dataSources.patch .

Vincula fuentes de datos

Las fuentes de datos de productos principales te permiten administrar la configuración predeterminada. regla de las fuentes de datos. La regla predeterminada es la que se aplica a todos los atributos de tu fuente de datos. La regla predeterminada se puede establecer cuando se crea la fuente de datos o cuando se actualiza una fuente de datos existente a través del campo de regla predeterminada.

La siguiente configuración de muestra garantiza que todos los atributos se tomen primero de la fuente de datos con el identificador único 1001. Luego, lo que falta se agregan desde la fuente de datos principal. Con el tiempo, los atributos restantes se tomarán de la fuente de datos complementaria con el identificador único 1002 si aún no se proporcionaron en ninguna otra fuente de datos. Si el mismo se proporciona en varias fuentes de datos, el valor más alto en la lista es seleccionado.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

Nota: No se pueden modificar las reglas personalizadas a través de la API.

Administración automática de feeds

Si quieres inscribir tu cuenta para la administración automática de fuentes de datos, debes hacer lo siguiente: lo siguiente:

• Para verificar si tu cuenta es apta para la inscripción, llama al método accounts.autofeedSettings.getAutofeedSettings.
• Asegúrate de que tu cuenta no pertenece a un mercado cuenta de servicio.

Una vez que tu cuenta sea apta para la inscripción, puedes usar el método accounts.autofeedSettings.updateAutofeedSettings para habilitar la administración automática de las fuentes de datos. Habilitación automática administración de fuentes de datos permite que Google agregue automáticamente los productos de tu tienda en línea y garantizar que estén siempre actualizadas en las plataformas de Google.

Cómo recuperar el estado de carga de un archivo

Para obtener el estado de una fuente de datos con un archivo, una recuperación o una hoja de cálculo, debes puedes llamar al método GET de la accounts.dataSources.fileUploads servicio. Para obtener el resultado de la última recuperación de la fuente de datos calculada de forma asíncrona cuando finaliza el procesamiento de la fuente de datos, usa el identificador de nombre latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

El estado de carga de archivos puede contener una vista detallada de tus productos, incluidos posibles problemas.

Ten en cuenta que es posible que el estado de carga del archivo no exista si nunca se subió. El estado de carga del archivo podría estar en estado de procesamiento si se solicita poco después. se subió el archivo.