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 formato:

customers/{customerId}/feeds/{feedId}

attributes[]

object (FeedAttribute)

Os 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. Não permitido em UPDATE. Use attributeOperations para adicionar novos atributos.

attributeOperations[]

object (FeedAttributeOperation)

A lista de operações que alteram os atributos do feed. 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 pelo Perfil da Empresa.

affiliateLocationFeedData

object (AffiliateLocationFeedData)

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

FeedAttribute

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

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

enum (FeedAttributeType)

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

id

string (int64 format)

ID do atributo.

name

string

O nome do atributo. Obrigatório.

isPartOfKey

boolean

Indica que os dados que correspondem a esse atributo fazem parte da chave exclusiva de um item de feed. O padrão será falso se não for especificado. Não é necessária uma chave exclusiva no esquema de um feed. Nesse caso, é necessário referenciar o feed_item_id do feed de feed.

FeedAttributeType

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o 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 o 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 o valor desconhecido nesta versão.
USER Os FeedAttributes para este 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. Esse tipo de feed é mantido pelo Google e tem os atributos corretos para o tipo de marcador de posição do feed.

FeedStatus

Status possíveis de um feed.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o 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 pelo 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 obrigatório (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 todos os subcampos.

businessAccountId

string

ID da página do Google+ 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 pode ser selecionado.

categoryFilters[]

string

Usado para filtrar fichas do Perfil da Empresa por categoria. Se existirem entradas em CategoryFilters, somente as fichas que pertencem a qualquer uma das categorias serão candidatas para sincronização nos ViewModels. Se não houver entradas em CategoryFilters, todas as fichas se qualificarão 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 estarão candidatas para sincronização com os ViewModels. Se não houver entradas em labelFilters, todas as fichas se qualificarão para sincronização.

emailAddress

string

Endereço de e-mail do Perfil da Empresa ou endereço de e-mail de um administrador do Perfil da Empresa. 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 estarão candidatas a serem sincronizadas nos 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 onde o feed de local de afiliado vai sincronizar os locais.

relationshipType

enum (AffiliateLocationFeedRelationshipType)

A relação das redes 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 o valor desconhecido nesta versão.
GENERAL_RETAILER Relacionamento geral com o varejista.