Feed

Um feed.

Representação 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

Imutável. O nome do recurso do feed. Os nomes dos recursos de feed têm o seguinte formato:

customers/{customerId}/feeds/{feedId}

attributes[]

object (FeedAttribute)

Atributos do feed. Obrigatório em CREATE, a menos que system_feed_generation_data seja fornecido. Nesse caso, o Google Ads atualizará o feed com os atributos corretos. Proibido em UPDATE. Use attributeOperations para adicionar novos atributos.

attributeOperations[]

object (FeedAttributeOperation)

A lista de operações que alteram os atributos do feed. Os atributos só podem ser adicionados, não removidos.

origin

enum (FeedOrigin)

Imutável. Especifica quem gerencia os FeedAttributes para o feed.

status

enum (FeedStatus)

Apenas saída. Status do feed. Este campo é somente leitura.

id

string (int64 format)

Apenas saída. O ID do feed. Este campo é somente leitura.

name

string

Imutável. Nome do feed. Obrigatório.

Campo de união system_feed_generation_data. Os dados do sistema para o feed. Esses dados especificam informações para gerar os itens do feed gerado pelo sistema. system_feed_generation_data pode ser apenas de um dos tipos a seguir:
placesLocationFeedData

object (PlacesLocationFeedData)

Dados usados para configurar um feed de local preenchido do Perfil da Empresa.

affiliateLocationFeedData

object (AffiliateLocationFeedData)

Dados usados para configurar um feed de local de afiliado preenchido com as redes especificadas.

FeedAttribute

FeedAttributes define os tipos de dados que devem estar presentes em um feed. Um único FeedAttribute especifica o tipo esperado de ViewPagerAttributes com o mesmo FeedAttributeId. Opcionalmente, um FeedAttribute pode ser marcado como parte da chave exclusiva de um ViewPager.

Representação JSON
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
Campos
type

enum (FeedAttributeType)

Tipo de dados do atributo de feed. Obrigatório.

id

string (int64 format)

ID do atributo.

name

string

O nome do atributo. Obrigatório.

isPartOfKey

boolean

Indica que os dados correspondentes a esse atributo fazem parte da chave exclusiva de um ViewModel. Se não for especificado, o padrão será "false". Uma chave exclusiva não é obrigatória no esquema de um feed. Nesse caso, os ViewModels precisam ser referenciados pelo feed_item_id.

FeedAttributeType

Possíveis tipos de dados para um atributo de feed.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
INT64 Int64.
DOUBLE Dobro
STRING String.
BOOLEAN Booleano.
URL URL.
DATE_TIME Data e hora.
INT64_LIST Int64.
DOUBLE_LIST Lista dupla (8 bytes).
STRING_LIST Lista de strings.
BOOLEAN_LIST Lista booleana.
URL_LIST Lista de URLs.
DATE_TIME_LIST Lista de data e hora.
PRICE Preço.

FeedAttributeOperation

Operação a ser realizada em uma lista de atributos de feed em uma função mutate.

Representação JSON
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
Campos
operator

enum (Operator)

Apenas saída. Tipo de operação de lista a ser executada.

value

object (FeedAttribute)

Apenas saída. O atributo do feed que está sendo adicionado à lista.

Operador

O operador.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ADD Adicione o atributo aos atributos existentes.

FeedOrigin

Valores possíveis para uma origem de feed.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
USER Os FeedAttributes desse feed são gerenciados pelo usuário. Os usuários podem adicionar FeedAttributes a este feed.
GOOGLE Os FeedAttributes de um feed do GOOGLE são criados pelo Google. Um feed desse tipo é mantido pelo Google e tem os atributos corretos para o tipo de marcador de posição do feed.

FeedStatus

Possíveis status de um feed.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED O feed está ativado.
REMOVED O feed foi removido.

PlacesLocationFeedData

Dados usados para configurar um feed de local preenchido do Perfil da Empresa.

Representação JSON
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
Campos
oauthInfo

object (OAuthInfo)

Imutável. Token de autenticação exigido (da API OAuth) para o e-mail. Esse campo só pode ser especificado em uma solicitação de criação. Não é possível selecionar nem todos os subcampos.

businessAccountId

string

ID da +Página da empresa gerenciada cujos locais devem ser usados. Se este campo não for definido, todas as empresas acessíveis pelo usuário (especificadas por emailAddress) serão usadas. Este campo é somente para mutação e não é selecionável.

categoryFilters[]

string

Usado para filtrar fichas do Perfil da Empresa por categoria. Se houver entradas em "categoryFilters", apenas as fichas de empresas que pertencem a qualquer uma das categorias serão candidatas a serem sincronizadas com os ViewModels. Se não houver entradas em "categoryFilters", todas as fichas estão candidatas para sincronização.

labelFilters[]

string

Usado para filtrar fichas do Perfil da Empresa por rótulos. Se houver entradas em labelFilters, somente as fichas com qualquer um dos rótulos definidos poderão ser sincronizadas com os ViewModels. Se não houver entradas em labelFilters, todas as fichas estão candidatas para sincronização.

emailAddress

string

Endereço de e-mail do Perfil da Empresa ou endereço de um administrador dele. Obrigatório.

businessNameFilter

string

Usado para filtrar fichas do Perfil da Empresa por nome. Se businessNameFilter estiver definido, apenas as fichas com um nome de empresa correspondente serão candidatas a serem sincronizadas com os ViewModels.

OAuthInfo

Dados usados para autorização com o OAuth.

Representação JSON
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
Campos
httpMethod

string

Método HTTP usado para receber autorização.

httpRequestUrl

string

O URL de solicitação HTTP usado para receber autorização.

httpAuthorizationHeader

string

O cabeçalho de autorização HTTP usado para receber autorização.

AffiliateLocationFeedData

Dados usados para configurar um feed de local de afiliado preenchido com as redes especificadas.

Representação JSON
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
Campos
chainIds[]

string (int64 format)

A lista de redes de que o feed de local de afiliado vai sincronizar os locais.

relationshipType

enum (AffiliateLocationFeedRelationshipType)

A relação que as redes têm com o anunciante.

AffiliateLocationFeedRelationshipType

Valores possíveis para um tipo de relacionamento para um feed de local de afiliado.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
GENERAL_RETAILER Relacionamento geral com o varejista.