- Recurso: DataSource
- PrimaryProductDataSource
- Canal
- SupplementalProductDataSource
- LocalInventoryDataSource
- RegionalInventoryDataSource
- PromotionDataSource
- Entrada
- FileInput
- FetchSettings
- TimeOfDay
- DayOfWeek
- Frecuencia
- FileInputType
- Métodos
Recurso: DataSource
Es la fuente de datos de la cuenta de Merchant Center.
Representación JSON |
---|
{ "name": string, "dataSourceId": string, "displayName": string, "input": enum ( |
Campos | |
---|---|
name |
Identificador. Es el nombre de la fuente de datos. Formato: |
dataSourceId |
Solo salida. Es el ID de la fuente de datos. |
displayName |
Obligatorio. Es el nombre de la fuente de datos que se muestra en la IU de Merchant Center. |
input |
Solo salida. Determina el tipo de entrada para la fuente de datos. Según la entrada, es posible que algunos parámetros de configuración no funcionen. Solo se pueden crear fuentes de datos genéricas a través de la API. |
fileInput |
Opcional. El campo solo se usa cuando los datos se administran a través de un archivo. |
Campo de unión Type . Es el tipo de fuente de datos. Las direcciones (Type ) solo pueden ser una de las siguientes opciones: |
|
primaryProductDataSource |
Obligatorio. Es la fuente de datos principal para productos locales y en línea. |
supplementalProductDataSource |
Obligatorio. Es la fuente de datos complementaria para los productos locales y en línea. |
localInventoryDataSource |
Obligatorio. Es la fuente de datos del inventario local. |
regionalInventoryDataSource |
Obligatorio. Es la fuente de datos del inventario regional. |
promotionDataSource |
Obligatorio. Es la fuente de datos de la promoción. |
PrimaryProductDataSource
Es la fuente principal de datos para productos locales y en línea.
Representación JSON |
---|
{
"channel": enum ( |
Campos | |
---|---|
channel |
Obligatorio. Inmutable. Especifica el tipo de canal de fuente de datos. |
countries[] |
Opcional. Indica los países en los que se pueden mostrar los artículos. Se representa como un código de territorio de CLDR. |
feedLabel |
Opcional. Inmutable. Es la etiqueta de feed que se especifica a nivel de la fuente de datos. Debe tener como máximo 20 letras mayúsculas (A-Z), números (0-9) y guiones (-). Consulta también la migración a las etiquetas de feed. Se deben establecer o no configurar Si se establece, la fuente de datos solo aceptará productos que coincidan con esta combinación. Si no la estableces, la fuente de datos aceptará productos sin esa restricción. |
contentLanguage |
Opcional. Inmutable. Es el lenguaje ISO 639-1 de dos letras de los elementos de la fuente de datos. Se deben establecer o no configurar Si se establece, la fuente de datos solo aceptará productos que coincidan con esta combinación. Si no la estableces, la fuente de datos aceptará productos sin esa restricción. |
Canal
Canal de fuente de datos.
El canal se utiliza para distinguir entre fuentes de datos para diferentes verticales de productos.
Enumeraciones | |
---|---|
CHANNEL_UNSPECIFIED |
No se especifica. |
ONLINE_PRODUCTS |
Producto en línea. |
LOCAL_PRODUCTS |
Producto local. |
PRODUCTS |
Fuente de datos unificada para productos locales y en línea. Nota: No se puede administrar productos mediante la API para este canal. |
SupplementalProductDataSource
La fuente de datos complementaria para productos locales y en línea.
Representación JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
Campos | |
---|---|
feedLabel |
Opcional. Inmutable. Es la etiqueta de feed que se especifica a nivel de la fuente de datos. Debe tener como máximo 20 letras mayúsculas (A-Z), números (0-9) y guiones (-). Consulta también la migración a las etiquetas de feed. Se deben establecer o no configurar Si se establece, la fuente de datos solo aceptará productos que coincidan con esta combinación. Si no se establece, la fuente de datos aceptará productos sin esa restricción. |
contentLanguage |
Opcional. Inmutable. Es el lenguaje ISO 639-1 de dos letras de los elementos de la fuente de datos. Se deben establecer o no configurar Si se establece, la fuente de datos solo aceptará productos que coincidan con esta combinación. Si no se establece, la fuente de datos aceptará productos sin esa restricción. |
LocalInventoryDataSource
La fuente de datos del inventario local
Representación JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
Campos | |
---|---|
feedLabel |
Obligatorio. Inmutable. Es la etiqueta de feed de las ofertas a las que se proporciona el inventario local. Debe tener como máximo 20 letras mayúsculas (A-Z), números (0-9) y guiones (-). Consulta también la migración a las etiquetas de feed. |
contentLanguage |
Obligatorio. Inmutable. Es el idioma ISO 639-1 de dos letras de los artículos en los que se proporciona el inventario local. |
RegionalInventoryDataSource
Es la fuente de datos del inventario regional.
Representación JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
Campos | |
---|---|
feedLabel |
Obligatorio. Inmutable. Es la etiqueta de feed de las ofertas a las que se proporciona el inventario regional. Debe tener como máximo 20 letras mayúsculas (A-Z), números (0-9) y guiones (-). Consulta también la migración a las etiquetas de feed. |
contentLanguage |
Obligatorio. Inmutable. Es el idioma ISO 639-1 de dos letras de los artículos a los que se proporciona el inventario regional. |
PromotionDataSource
Es la fuente de datos de promociones.
Representación JSON |
---|
{ "targetCountry": string, "contentLanguage": string } |
Campos | |
---|---|
targetCountry |
Obligatorio. Inmutable. Indica el país de segmentación que se utiliza como parte del identificador único. Se representa como un código de territorio de CLDR. Las promociones solo están disponibles en determinados países. |
contentLanguage |
Obligatorio. Inmutable. Es el lenguaje ISO 639-1 de dos letras de los elementos de la fuente de datos. |
Entrada
Determina el tipo de entrada para la fuente de datos. Según la entrada, es posible que no se admitan algunos parámetros de configuración.
Enumeraciones | |
---|---|
INPUT_UNSPECIFIED |
Entrada sin especificar. |
API |
Representa fuentes de datos para las que los datos se proporcionan principalmente a través de la API. |
FILE |
Representa fuentes de datos para las que los datos se proporcionan principalmente a través de entradas de archivos. De todos modos, se pueden proporcionar datos a través de la API. |
UI |
La fuente de datos de los productos que se agregaron directamente en Merchant Center. Con esta API, no se puede crear ni actualizar este tipo de fuente de datos. Solo se puede usar la IU de Merchant Center en esta API. Este tipo de fuente de datos es de solo lectura. |
AUTOFEED |
Esto también se conoce como feeds automáticos y se usa para crear los datos de productos automáticamente. Este tipo de fuente de datos se puede habilitar o inhabilitar a través del paquete Cuentas. |
FileInput
Los datos específicos de las fuentes de datos de archivos. Este campo está vacío para otras entradas de fuente de datos.
Representación JSON |
---|
{ "fetchSettings": { object ( |
Campos | |
---|---|
fetchSettings |
Opcional. Recupera detalles para entregar la fuente de datos. Contiene la configuración para los tipos de entrada de archivo |
fileName |
Opcional. Es el nombre de archivo de la fuente de datos. Obligatorio para el tipo de entrada del archivo |
fileInputType |
Solo salida. Es el tipo de entrada de archivo. |
FetchSettings
Recupera detalles para entregar la fuente de datos.
Representación JSON |
---|
{ "enabled": boolean, "dayOfMonth": integer, "timeOfDay": { object ( |
Campos | |
---|---|
enabled |
Opcional. Habilita o detiene la programación de actualización de información. |
dayOfMonth |
Opcional. El día del mes en el que se debe recuperar el archivo de fuente de datos (1-31). Este campo solo se puede configurar para la frecuencia mensual. |
timeOfDay |
Opcional. La hora del día en la que se debe recuperar el archivo de fuente de datos. Los minutos y segundos no son compatibles, por lo que se ignorarán. |
dayOfWeek |
Opcional. El día de la semana en que se debe recuperar el archivo de fuente de datos. Este campo solo se puede configurar para la frecuencia semanal. |
timeZone |
Opcional. Se usa la zona horaria para el programa. UTC de forma predeterminada. Por ejemplo, “America/Los_Angeles”. |
frequency |
Obligatorio. La frecuencia con la que se describe el programa de recuperación. |
fetchUri |
Opcional. Es la URL en la que se puede recuperar el archivo de fuente de datos. Google Merchant Center admite cargas programadas automáticas con los protocolos HTTP, HTTPS o SFTP, por lo que el valor deberá ser un vínculo válido que use uno de esos tres protocolos. Inmutable para archivos de Hojas de cálculo de Google |
username |
Opcional. Un nombre de usuario opcional para [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Se usa para enviar fuentes de datos a través del SFTP. |
password |
Opcional. Una contraseña opcional para [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Se usa para enviar fuentes de datos a través del SFTP. |
TimeOfDay
Representa una hora del día. La fecha y la zona horaria no son significativas o se especifican en otro lugar. Una API puede optar por permitir segundos bisiestos. Los tipos relacionados son google.type.Date
y google.protobuf.Timestamp
.
Representación JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Campos | |
---|---|
hours |
Horas del día en formato de 24 horas. Debe ser del 0 al 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas. |
minutes |
Minutos de horas del día. Debe ser un valor entre 0 y 59. |
seconds |
Segundos de minutos de la hora. Por lo general, debe ser un valor entre 0 y 59. Una API puede permitir el valor 60 si permite segundos bisiestos. |
nanos |
Fracciones de segundos en nanosegundos. Debe ser un valor entre 0 y 999,999,999. |
DayOfWeek
Representa un día de la semana.
Enumeraciones | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
No se especifica el día de la semana. |
MONDAY |
Lunes |
TUESDAY |
Martes |
WEDNESDAY |
Miércoles |
THURSDAY |
Jueves |
FRIDAY |
Viernes |
SATURDAY |
Sábado |
SUNDAY |
Domingo |
Frecuencia
Los campos obligatorios varían según la frecuencia de recuperación. Para una programación de actualización mensual, se requieren [día del mes][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] y [hora del día][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. Para una programación de actualización semanal, se requieren [día de la semana][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] y [hora del día][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. Para una programación de recuperación diaria, solo se requiere una [hora del día][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day].
Enumeraciones | |
---|---|
FREQUENCY_UNSPECIFIED |
Frecuencia sin especificar. |
FREQUENCY_DAILY |
La recuperación se realiza todos los días. |
FREQUENCY_WEEKLY |
La recuperación se realiza todas las semanas. |
FREQUENCY_MONTHLY |
La recuperación se realiza todos los meses. |
FileInputType
Es el método de entrega de archivos.
Enumeraciones | |
---|---|
FILE_INPUT_TYPE_UNSPECIFIED |
Tipo de entrada del archivo sin especificar. |
UPLOAD |
El archivo se sube a través de SFTP, Google Cloud Storage o de forma manual a Merchant Center. |
FETCH |
El archivo se recupera del [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] configurado. |
GOOGLE_SHEETS |
El archivo se recupera de las Hojas de cálculo de Google que se especifican en el [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
Métodos |
|
---|---|
|
Crea la nueva configuración de fuente de datos para la cuenta determinada. |
|
Borra una fuente de datos de tu cuenta de Merchant Center. |
|
Realiza la recuperación de datos de inmediato (incluso fuera de la programación de recuperación) en una fuente de datos de tu cuenta de Merchant Center. |
|
Recupera la configuración de fuente de datos de la cuenta determinada. |
|
Enumera las configuraciones de las fuentes de datos de la cuenta determinada. |
|
Actualiza la configuración de la fuente de datos existente. |