En esta página, se muestra cómo crear y actualizar de manera programática las 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 automatizadas garantizan que la información actualizada sobre los productos relevantes de tu sitio web llegan a Google.
Content API for Shopping solo te permite crear fuentes de datos principales. Con Merchant Data Sources en la API, 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 un valorcontentLanguage
- Crea una fuente de datos comodín. Una fuente de datos comodín no tiene
feedLabel
ycontentLanguage
configurados. 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.
- Inscribe tu cuenta para la administración automática de las fuentes de datos.
- Administra fuentes de datos de 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.
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 segmentación de datos, usa el una lista de fuentes de datos o 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
Para crear una nueva fuente de datos principal con un feedLabel
específico y
contentLanguage
, configura los campos feedLabel
y contentLanguage
en la
específica 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 usando
PrimaryProductDataSource
y no establezcas los campos feedLabel
y contentLanguage
.
Cuando se usa Content API for Shopping, se crea solo una fuente de datos de API para ti. Con la API de Merchant Data Sources, puede tener varias fuentes de datos de API, algunas pueden ser comodines.
Solo las fuentes de datos con entrada de la API pueden ser fuentes de datos comodín. Datos comodín Las fuentes no son compatibles con las entradas de archivo.
Crear una fuente de datos complementaria y vincularla a la fuente de datos principal
Puedes usar fuentes de datos complementarias para realizar actualizaciones parciales en los datos de productos. Para ello, haz lo siguiente:
agregar el identificador único de la fuente de datos como parámetro de consulta cuando se realice
llamadas a la
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 usando
SupplementalProductDataSource
y, luego, vincúlalo actualizando defaultRule
de tu fuente de datos principal.
Las fuentes de datos de archivos complementarias no pueden ser fuentes de datos comodín. API complementaria las fuentes de datos siempre deben ser fuentes de datos comodín.
Configura un programa para tu fuente de datos de archivos
Para programar tu feed de archivos, configura la fuente de datos como un archivo
usando 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
.
Recuperar fuente de datos
Para recuperar un archivo configurado en la fuente de datos, usa el
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
.
Vincular 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 atributos de tu fuente de datos. La regla predeterminada puede establecerse mientras se crea o actualizando una existente a través de la regla predeterminada .
El siguiente ejemplo de configuración 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. Eventualmente, los recursos restantes
los atributos se tomarán de la fuente de datos complementaria con el conjunto de datos
el identificador 1002
si aún no se proporcionó 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
]
}
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:
- Verifica si tu cuenta cumple con los requisitos de inscripción. Para ello, llama al
Accounts.AutofeedSettings.Get
. - 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, podrás usar la
Método Accounts.AutofeedSettings.Update
para habilitar la administración automática de datos
fuentes de datos. Si habilitas la administración automática de fuentes de datos, Google podrá
agregar tus productos desde tu tienda en línea y asegurarte de que siempre estén actualizados
en las plataformas de Google.
Cómo recuperar el estado de carga de archivos
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
del servicio FileUpload
. Para obtener el resultado de
la última recuperación de la fuente de datos calculada de forma asíncrona cuando los datos
Finalizó el procesamiento de la fuente, usa el identificador de nombre latest
.
GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest
El estado de carga del archivo puede contener una vista detallada de tus productos, incluida la cualquier problema potencial.
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.