REST Resource: accounts.dataSources

Recurso: DataSource

Es la fuente de datos de la cuenta de Merchant Center.

Representación JSON
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  }
  // End of list of possible types for union field Type.
}
Campos
name

string

Identificador. Es el nombre de la fuente de datos. Formato: {datasource.name=accounts/{account}/dataSources/{datasource}}

dataSourceId

string (int64 format)

Solo salida. Es el ID de la fuente de datos.

displayName

string

Obligatorio. Es el nombre de la fuente de datos que se muestra en la IU de Merchant Center.

input

enum (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

object (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

object (PrimaryProductDataSource)

Obligatorio. Es la fuente de datos principal para productos locales y en línea.

supplementalProductDataSource

object (SupplementalProductDataSource)

Obligatorio. Es la fuente de datos complementaria para los productos locales y en línea.

localInventoryDataSource

object (LocalInventoryDataSource)

Obligatorio. Es la fuente de datos del inventario local.

regionalInventoryDataSource

object (RegionalInventoryDataSource)

Obligatorio. Es la fuente de datos del inventario regional.

promotionDataSource

object (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 (Channel),
  "countries": [
    string
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Campos
channel

enum (Channel)

Obligatorio. Inmutable. Especifica el tipo de canal de fuente de datos.

countries[]

string

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

string

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 feedLabel y contentLanguage para las fuentes de datos con el tipo de contenido de productos. Se deben configurar para fuentes de datos con una entrada de archivo.

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

string

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 feedLabel y contentLanguage. Los campos solo se pueden desactivar para fuentes de datos sin entrada de archivo.

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

string

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 feedLabel y contentLanguage para las fuentes de datos con el tipo de contenido de productos. Se deben configurar para fuentes de datos con una entrada de archivo.

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

string

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 feedLabel y contentLanguage. Los campos solo se pueden desactivar para fuentes de datos sin entrada de archivo.

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

string

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

string

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

string

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

string

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

string

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

string

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 (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Campos
fetchSettings

object (FetchSettings)

Opcional. Recupera detalles para entregar la fuente de datos. Contiene la configuración para los tipos de entrada de archivo FETCH y GOOGLE_SHEETS. Los campos obligatorios varían según la frecuencia de recuperación.

fileName

string

Opcional. Es el nombre de archivo de la fuente de datos. Obligatorio para el tipo de entrada del archivo UPLOAD.

fileInputType

enum (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 (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
Campos
enabled

boolean

Opcional. Habilita o detiene la programación de actualización de información.

dayOfMonth

integer

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

object (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

enum (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

string

Opcional. Se usa la zona horaria para el programa. UTC de forma predeterminada. Por ejemplo, “America/Los_Angeles”.

frequency

enum (Frequency)

Obligatorio. La frecuencia con la que se describe el programa de recuperación.

fetchUri

string

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

string

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

string

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

integer

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

integer

Minutos de horas del día. Debe ser un valor entre 0 y 59.

seconds

integer

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

integer

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

create

Crea la nueva configuración de fuente de datos para la cuenta determinada.

delete

Borra una fuente de datos de tu cuenta de Merchant Center.

fetch

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.

get

Recupera la configuración de fuente de datos de la cuenta determinada.

list

Enumera las configuraciones de las fuentes de datos de la cuenta determinada.

patch

Actualiza la configuración de la fuente de datos existente.