REST Resource: accounts.dataSources

Recurso: DataSource

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)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // 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 a 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. El tipo de fuente de datos. Las direcciones (Type) solo pueden ser una de las siguientes opciones:
primaryProductDataSource

object (PrimaryProductDataSource)

Obligatorio. La fuente de datos principal para los productos locales y en línea.
supplementalProductDataSource

object (SupplementalProductDataSource)

Obligatorio. La fuente de datos complementaria para productos locales y en línea.
localInventoryDataSource

object (LocalInventoryDataSource)

Obligatorio. La fuente de datos del inventario local
regionalInventoryDataSource

object (RegionalInventoryDataSource)

Obligatorio. La fuente de datos del inventario regional
promotionDataSource

object (PromotionDataSource)

Obligatorio. La fuente de datos de promoción
productReviewDataSource

object (ProductReviewDataSource)

Obligatorio. La fuente de datos de opiniones sobre productos
merchantReviewDataSource

object (MerchantReviewDataSource)

Obligatorio. La fuente de datos de las opiniones sobre comercios

PrimaryProductDataSource

La fuente de datos principal para los productos locales y en línea.

Representación JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
Campos
channel

enum (Channel)

Obligatorio. Inmutable. Especifica el tipo de canal de fuente de datos.
countries[]

string

Opcional. Los países en los que se pueden mostrar los artículos. Se representa como un código de territorio de CLDR.
defaultRule

object (DefaultRule)

Opcional. Administración de reglas predeterminadas de la fuente de datos. Si se establece, se reemplazarán las fuentes de datos vinculadas.
feedLabel

string

Opcional. Inmutable. Es la etiqueta del feed que se especifica a nivel de la fuente de datos.

Debe tener menos de 20 letras mayúsculas (A-Z), números (0-9) y guiones (-).

Consulta también la migración a etiquetas de feeds.

feedLabel y contentLanguage deben estar configurados o no 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 idioma ISO 639-1 de dos letras de los artículos de la fuente de datos.

feedLabel y contentLanguage deben establecerse o no establecerse. Los campos solo se pueden restablecer para las fuentes de datos sin entrada de archivos.

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.

Canal

Canal de la fuente de datos.

El canal se usa para distinguir entre las fuentes de datos de 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 es posible administrar productos a través de la API para este canal.

DefaultRule

Administración de reglas predeterminadas de la fuente de datos.

Representación JSON 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
Campos
takeFromDataSources[]

object (DataSourceReference)

Obligatorio. La lista de fuentes de datos vinculadas en la regla predeterminada Esta lista se ordena según la prioridad predeterminada de la regla para unir los datos. Puede incluir una o varias referencias a self y fuentes de datos complementarias.

La lista no debe estar vacía.

Para vincular la fuente de datos a la regla predeterminada, debes agregar una referencia nueva a esta lista (en orden secuencial).

Para desvincular la fuente de datos de la regla predeterminada, debes quitar la referencia determinada de esta lista.

Si cambias el orden de esta lista, se cambiará la prioridad de las fuentes de datos en la regla predeterminada.

Por ejemplo, si proporcionas la siguiente lista: [1001, self], se tomarán los valores del atributo de la fuente de datos complementaria 1001 y se usará self como alternativa si el atributo no está configurado en 1001.

DataSourceReference

La referencia de la fuente de datos se puede usar para administrar fuentes de datos relacionadas dentro del servicio de fuentes de datos.

Representación JSON 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
Campos

Campo de unión data_source_id.

data_source_id puede ser una de las siguientes opciones:
self

boolean

Self se debe usar para hacer referencia a la fuente de datos principal.
primaryDataSourceName

string

Opcional. Es el nombre de la fuente de datos principal. Formato: accounts/{account}/dataSources/{datasource}
supplementalDataSourceName

string

Opcional. Es el nombre de la fuente de datos complementaria. Formato: accounts/{account}/dataSources/{datasource}

SupplementalProductDataSource

La fuente de datos complementaria para los productos locales y en línea. Después de crearla, asegúrate de vincular la fuente de datos de productos complementarios a una o más fuentes de datos de productos principales.

Representación JSON 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Campos
referencingPrimaryDataSources[]

object (DataSourceReference)

Solo salida. Es la lista (no ordenada y sin duplicados) de todas las fuentes de datos principales vinculadas a esta fuente de datos en reglas predeterminadas o personalizadas. No se puede borrar la fuente de datos complementaria antes de quitar todos los vínculos.
feedLabel

string

Opcional. Inmutable. Es la etiqueta del feed que se especifica a nivel de la fuente de datos.

Debe tener menos de 20 letras mayúsculas (A-Z), números (0-9) y guiones (-).

Consulta también la migración a etiquetas de feeds.

feedLabel y contentLanguage deben estar configurados o no para las fuentes de datos con el tipo de contenido de productos.

Se deben configurar para fuentes de datos con un file input. Los campos no se deben establecer para las fuentes de datos sin file input.

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 idioma ISO 639-1 de dos letras de los artículos de la fuente de datos.

feedLabel y contentLanguage deben establecerse o no establecerse. Los campos solo se pueden restablecer para las fuentes de datos sin entrada de archivos.

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. La etiqueta del feed de las ofertas a las que se proporciona el inventario local.

Debe tener menos de 20 letras mayúsculas (A-Z), números (0-9) y guiones (-).

Consulta también la migración a etiquetas de feeds.
contentLanguage

string

Obligatorio. Inmutable. Es el idioma ISO 639-1 de dos letras de los artículos a los que se proporciona el inventario local.

RegionalInventoryDataSource

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 menos de 20 letras mayúsculas (A-Z), números (0-9) y guiones (-).

Consulta también la migración a etiquetas de feeds.
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

La fuente de datos de la promoción.

Representación JSON 
{
  "targetCountry": string,
  "contentLanguage": string
}
Campos
targetCountry

string

Obligatorio. Inmutable. Es el país de destino que se usa como parte del identificador único. Se representa como un código de territorio de CLDR.

Las promociones solo están disponibles en países seleccionados.
contentLanguage

string

Obligatorio. Inmutable. Es el idioma ISO 639-1 de dos letras de los artículos de la fuente de datos.

ProductReviewDataSource

Este tipo no tiene campos.

La fuente de datos de opiniones sobre productos.

MerchantReviewDataSource

Este tipo no tiene campos.

La fuente de datos de opiniones sobre comercios.

Entrada

Determina el tipo de entrada a la fuente de datos. Según la entrada, es posible que algunos parámetros de configuración no sean compatibles.

Enumeraciones
INPUT_UNSPECIFIED No se especificó la entrada.
API Representa las fuentes de datos para las que los datos se proporcionan principalmente a través de la API.
FILE Representa las fuentes de datos para las que los datos se proporcionan principalmente a través de la entrada de archivos. Los datos aún se pueden proporcionar a través de la API.
UI

Es la fuente de datos de los productos que se agregaron directamente en Merchant Center.

Este tipo de fuente de datos no se puede crear ni actualizar a través de esta API, solo a través de la IU de Merchant Center.

Este tipo de fuente de datos es de solo lectura.
AUTOFEED Esto también se conoce como feeds automáticos, que se usan para crear automáticamente tus datos de productos. 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 fuentes 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 parámetros de configuración para los tipos de entrada de archivos 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 de 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 pausa la programación de recuperación.
dayOfMonth

integer

Opcional. Es el día del mes en el que se debe recuperar el archivo de la fuente de datos (del 1 al 31). Este campo solo se puede configurar para la frecuencia mensual.
timeOfDay

object (TimeOfDay)

Opcional. Es la hora del día en la que se debe recuperar el archivo de la fuente de datos. Los minutos y segundos no son compatibles y se ignorarán.
dayOfWeek

enum (DayOfWeek)

Opcional. Es el día de la semana en el que se debe recuperar el archivo de la fuente de datos. Este campo solo se puede establecer para la frecuencia semanal.
timeZone

string

Opcional. Zona horaria que se usa para la programación. UTC de forma predeterminada. Por ejemplo, “America/Los_Angeles”.
frequency

enum (Frequency)

Obligatorio. Es la frecuencia que describe la programación de recuperación.
fetchUri

string

Opcional. Es la URL desde la que se puede recuperar el archivo de la fuente de datos. Google Merchant Center admite cargas automáticas programadas con los protocolos HTTP, HTTPS o SFTP, por lo que el valor debe ser un vínculo válido con uno de esos tres protocolos. Es inmutable para los archivos de Hojas de cálculo de Google.
username

string

Opcional. Es un nombre de usuario opcional para fetchUri. Se usa para enviar fuentes de datos a través de SFTP.
password

string

Opcional. Una contraseña opcional para fetchUri. Se usa para enviar fuentes de datos a través de 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 de un día en formato de 24 horas. Debe ser mayor o igual que 0 y, por lo general, debe ser menor o igual que 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.
minutes

integer

Minutos de una hora. Debe ser mayor o igual que 0 y menor o igual que 59.
seconds

integer

Son los segundos de un minuto. Debe ser mayor o igual que 0 y, por lo general, debe ser menor o igual que 59. Una API puede permitir el valor 60 si permite segundos bisiestos.
nanos

integer

Fracciones de segundos, en nanosegundos. Debe ser mayor o igual que 0 y menor o igual que 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 un programa de recuperació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 un programa de recuperació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 un programa de actualización diaria, solo se requiere un [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day].

Enumeraciones
FREQUENCY_UNSPECIFIED No se especificó la frecuencia.
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 publicación de archivos.

Enumeraciones
FILE_INPUT_TYPE_UNSPECIFIED No se especificó el tipo de entrada de archivo.
UPLOAD El archivo se sube a través de SFTP, Google Cloud Storage o de forma manual en Merchant Center.
FETCH El archivo se recupera del fetchUri configurado.
GOOGLE_SHEETS El archivo se recupera de Hojas de cálculo de Google especificado en fetchUri.

Métodos

create

 Crea la nueva configuración de la 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 la fuente de datos de la cuenta determinada.

list

 Muestra una lista de las configuraciones de las fuentes de datos de la cuenta determinada.

patch

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