En esta página, se muestra cómo crear y actualizar de manera programática las fuentes de datos que te permiten insertar productos. Las fuentes de datos automatizadas facilitan el envío de tus datos de productos a Google. Las fuentes de datos automatizadas garantizan 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 del inventario regional
- Fuentes de datos de promociones
Solo se permite la administración de fuentes de datos con entradas de archivos de Content API for Shopping. 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 uncontentLanguage
específicos. - Crea una fuente de datos comodín. Una fuente de datos comodín no tiene configurados los campos
feedLabel
ycontentLanguage
. Las fuentes de datos comodín te permiten insertar productos con diferentes combinaciones defeedLabel
ycontentLanguage
en una 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.
- Administra fuentes de datos de API.
- Usa otros tipos de fuentes de datos, como las promociones.
Requisitos previos
- Tu cuenta se debe haber migrado a feeds de configuración regional únicos.
Para verificar que la cuenta ya se migró a la división de destino 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 deberás 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
Para crear una nueva fuente de datos principal con feedLabel
y contentLanguage
específicos, establece los campos feedLabel
y contentLanguage
en la configuración de tipo específico. Por ejemplo, PrimaryProductDataSource
.
Para ver la fuente de datos que acabas de crear, crea una solicitud GET
o LIST
.
Crear una nueva fuente de datos principal comodín
Para crear un nuevo feed principal comodín, configura tu fuente de datos con
PrimaryProductDataSource
y no establezcas los campos feedLabel
ni contentLanguage
.
Con Content API for Shopping, solo se crea una fuente de datos de API para ti. Con la API de fuentes de datos de Merchant Center, puedes tener varias fuentes de datos de API, algunas de las cuales pueden ser comodines.
Solo las fuentes de datos con entrada de la API pueden ser fuentes de datos comodín. Las fuentes de datos comodín no son compatibles con las entradas de archivos.
Crear una fuente de datos complementaria y vincularla a la fuente de datos principal
Puedes usar fuentes de datos complementarias para realizar actualizaciones parciales de los datos de productos si agregas el identificador único de la fuente de datos como un parámetro de consulta cuando realizas llamadas a los métodos accounts.productInputs.insert
y accounts.productInputs.delete
. Solo puedes usar fuentes de datos complementarias para actualizar los productos existentes.
Para crear una fuente de datos complementaria, configura tu fuente de datos con
SupplementalProductDataSource
y, luego, vincúlala mediante la actualización del campo defaultRule
en la fuente de datos principal.
Las fuentes de datos de archivos complementarias no pueden ser fuentes de datos comodín. Las fuentes de datos de API complementarias siempre deben ser fuentes de datos comodín.
Configura un programa para tu fuente de datos de archivos
Si quieres programar el feed de archivos, usa el campo FileInput
para configurar fetchsettings
y usa el campo FileInput.FetchSettings
para que la fuente de datos sea una fuente de datos de archivos.
Cómo borrar una fuente de datos
Para borrar una fuente de datos existente de tu cuenta, usa el método accounts.dataSources.delete
.
Recuperar 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 de inmediato en una fuente de datos de 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 la fuente de datos de tu cuenta, usa el método accounts.dataSources.get
.
Enumerar fuentes de datos
Para enumerar las opciones de configuración de las fuentes de datos de tu cuenta, usa el método accounts.dataSources.list
.
Aplicar parche a la fuente de datos
Para actualizar la configuración de una fuente de datos existente, usa el método accounts.dataSources.patch
.