Feed

Un feed.

Representación JSON
{
  "resourceName": string,
  "attributes": [
    {
      object (FeedAttribute)
    }
  ],
  "attributeOperations": [
    {
      object (FeedAttributeOperation)
    }
  ],
  "origin": enum (FeedOrigin),
  "status": enum (FeedStatus),
  "id": string,
  "name": string,

  // Union field system_feed_generation_data can be only one of the following:
  "placesLocationFeedData": {
    object (PlacesLocationFeedData)
  },
  "affiliateLocationFeedData": {
    object (AffiliateLocationFeedData)
  }
  // End of list of possible types for union field system_feed_generation_data.
}
Campos
resourceName

string

Inmutable. Es el nombre del recurso del feed. Los nombres de los recursos del feed tienen el siguiente formato:

customers/{customerId}/feeds/{feedId}

attributes[]

object (FeedAttribute)

Los atributos del feed Es obligatorio el CREATE, a menos que se proporcione el valor system_feed_generation_data, en cuyo caso Google Ads actualizará el feed con los atributos correctos. No permitido en UPDATE. Usa attributeOperations para agregar atributos nuevos.

attributeOperations[]

object (FeedAttributeOperation)

Es la lista de las operaciones que cambian los atributos del feed. Los atributos solo se pueden agregar, no quitar.

origin

enum (FeedOrigin)

Inmutable. Especifica quién administra los FeedAttributes del feed.

status

enum (FeedStatus)

Solo salida. Estado del feed. Este campo es de solo lectura.

id

string (int64 format)

Solo salida. El ID del feed. Este campo es de solo lectura.

name

string

Inmutable. Es el nombre del feed. Obligatorio.

Campo de unión system_feed_generation_data. Son los datos del sistema del feed. Estos datos especifican información para generar los elementos del feed generado por el sistema. Las direcciones (system_feed_generation_data) solo pueden ser una de las siguientes opciones:
placesLocationFeedData

object (PlacesLocationFeedData)

Son los datos que se usan para configurar un feed de ubicación que se propaga desde el Perfil de Negocio.

affiliateLocationFeedData

object (AffiliateLocationFeedData)

Son los datos que se usan para configurar un feed de ubicación afiliada que se propaga con las cadenas especificadas.

FeedAttribute

Los atributos de feed definen los tipos de datos que se espera que estén presentes en un feed. Un solo FeedAttribute especifica el tipo esperado de los FeedItemAttributes con el mismo FeedAttributeId. De manera opcional, un FeedAttribute se puede marcar como parte de la clave única de un FeedItem.

Representación JSON
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
Campos
type

enum (FeedAttributeType)

Es el tipo de datos del atributo del feed. Obligatorio.

id

string (int64 format)

Es el ID del atributo.

name

string

Es el nombre del atributo. Obligatorio.

isPartOfKey

boolean

Indica que los datos que corresponden a este atributo forman parte de la clave única de un FeedItem. Si no se especifica, el valor predeterminado es falso. Ten en cuenta que no se requiere una clave única en el esquema de un feed, en cuyo caso se debe hacer referencia a los elementos del feed con su feed_item_id.

FeedAttributeType

Tipos de datos posibles para un atributo del feed.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
INT64 Valor interno 64.
DOUBLE Doble.
STRING String.
BOOLEAN Booleano.
URL URL.
DATE_TIME Fecha y hora.
INT64_LIST Lista Int64.
DOUBLE_LIST Lista doble (8 bytes).
STRING_LIST Lista de strings.
BOOLEAN_LIST Lista de booleanos.
URL_LIST Lista de URLs.
DATE_TIME_LIST Lista de fecha y hora.
PRICE Precio

FeedAttributeOperation

Operación que se realizará en una lista de atributos del feed en una mutación.

Representación JSON
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
Campos
operator

enum (Operator)

Solo salida. El tipo de operación de lista que se debe realizar.

value

object (FeedAttribute)

Solo salida. El atributo del feed que se agrega a la lista.

Operador

El operador.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
ADD Agrega el atributo a los atributos existentes.

FeedOrigin

Valores posibles de un origen de feed.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
USER El usuario administra los FeedAttributes para este feed. Los usuarios pueden agregar FeedAttributes a este feed.
GOOGLE Google crea los atributos FeedAttributes para un feed de GOOGLE. Google mantiene un feed de este tipo, que tendrá los atributos correctos para el tipo de marcador de posición del feed.

FeedStatus

Estos son los posibles estados de un feed.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
ENABLED El feed está habilitado.
REMOVED Se quitó el feed.

PlacesLocationFeedData

Son los datos que se usan para configurar un feed de ubicación que se propaga desde el Perfil de Negocio.

Representación JSON
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
Campos
oauthInfo

object (OAuthInfo)

Inmutable. Token de autenticación requerido (de la API de OAuth) para el correo electrónico. Este campo solo se puede especificar en una solicitud de creación. No se pueden seleccionar todos sus subcampos.

businessAccountId

string

ID de la página de Google+ de la empresa administrada cuyas ubicaciones se deben utilizar. Si no se establece este campo, se utilizarán todas las empresas a las que pueda acceder el usuario (especificado mediante emailAddress). Este campo es solo de mutación y no se puede seleccionar.

categoryFilters[]

string

Se usa para filtrar las fichas del Perfil de Negocio por categorías. Si las entradas existen en categoryFilters, solo las fichas que pertenecen a alguna de las categorías son candidatas para sincronizarse en FeedItems. Si no existen entradas en categoryFilters, todas las fichas son candidatas para la sincronización.

labelFilters[]

string

Se usa para filtrar las fichas del Perfil de Negocio por etiquetas. Si existen entradas en labelFilters, solo las fichas que tengan configurada cualquiera de las etiquetas serán candidatas para sincronizarse en FeedItems. Si no existen entradas en labelFilters, todas las fichas son candidatas para la sincronización.

emailAddress

string

Dirección de correo electrónico de un Perfil de Negocio o dirección de correo electrónico de un administrador del Perfil de Negocio. Obligatorio.

businessNameFilter

string

Se usa para filtrar las fichas del Perfil de Negocio por nombre de la empresa. Si se establece businessNameFilter, solo las fichas cuyo nombre de empresa coincida serán candidatas para sincronizarse en FeedItems.

OAuthInfo

Datos que se usan para la autorización mediante OAuth.

Representación JSON
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
Campos
httpMethod

string

Es el método HTTP que se usa para obtener la autorización.

httpRequestUrl

string

La URL de solicitud HTTP que se usa para obtener la autorización.

httpAuthorizationHeader

string

Es el encabezado de autorización HTTP que se usa para obtener la autorización.

AffiliateLocationFeedData

Son los datos que se usan para configurar un feed de ubicación afiliada que se propaga con las cadenas especificadas.

Representación JSON
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
Campos
chainIds[]

string (int64 format)

Es la lista de cadenas desde las que el feed de ubicación afiliada sincronizará las ubicaciones.

relationshipType

enum (AffiliateLocationFeedRelationshipType)

Es la relación que tienen las cadenas con el anunciante.

AffiliateLocationFeedRelationshipType

Valores posibles de un tipo de relación en un feed de ubicación afiliada.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
GENERAL_RETAILER Relación general con el minorista.