FeedItem

Um item de feed.

Representação JSON
{
  "resourceName": string,
  "attributeValues": [
    {
      object (FeedItemAttributeValue)
    }
  ],
  "geoTargetingRestriction": enum (GeoTargetingRestriction),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (FeedItemStatus),
  "policyInfos": [
    {
      object (FeedItemPlaceholderPolicyInfo)
    }
  ],
  "feed": string,
  "id": string,
  "startDateTime": string,
  "endDateTime": string
}
Campos
resourceName

string

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

customers/{customerId}/feedItems/{feedId}~{feed_item_id}

attributeValues[]

object (FeedItemAttributeValue)

Valores de atributo do item do feed.

geoTargetingRestriction

enum (GeoTargetingRestriction)

A restrição de segmentação por área geográfica especifica o tipo de local que pode ser usado para segmentação.

urlCustomParameters[]

object (CustomParameter)

A lista de mapeamentos usados para substituir tags de parâmetros personalizados em um trackingUrlTemplate, um finalUrls ou um mobile_final_urls.

status

enum (FeedItemStatus)

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

policyInfos[]

object (FeedItemPlaceholderPolicyInfo)

Apenas saída. Lista de informações sobre o estado de validação e aprovação de um item do feed para mapeamentos de feeds ativos. Há uma entrada na lista para cada tipo de mapeamento associado ao feed. Por exemplo, um feed com um sitelink e um mapeamento de feed de chamadas faria com que todos os itens do feed associados a esse feed tivessem uma entrada na lista para sitelink e chamada. Este campo é somente leitura.

feed

string

Imutável. O feed ao qual o item pertence.

id

string (int64 format)

Apenas saída. O ID desse item do feed.

startDateTime

string

Horário de início em que o item do feed está em vigor e pode começar a ser veiculado. A hora está no fuso horário do cliente. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"

endDateTime

string

Horário de término em que esse item do feed não está mais disponível e vai deixar de ser veiculado. A hora está no fuso horário do cliente. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"

FeedItemAttributeValue

Um valor de atributo do item de feed.

Representação JSON
{
  "priceValue": {
    object (Money)
  },
  "integerValues": [
    string
  ],
  "booleanValues": [
    boolean
  ],
  "stringValues": [
    string
  ],
  "doubleValues": [
    number
  ],
  "feedAttributeId": string,
  "integerValue": string,
  "booleanValue": boolean,
  "stringValue": string,
  "doubleValue": number
}
Campos
priceValue

object (Money)

Valor do preço. Precisa ser definido se feedAttributeId se referir a um atributo de feed do tipo PRICE.

integerValues[]

string (int64 format)

Valor int64 repetido. Precisa ser definido se feedAttributeId se referir a um atributo de feed do tipo INT64_LIST.

booleanValues[]

boolean

Valor booleano repetido. Precisa ser definido se feedAttributeId se referir a um atributo de feed do tipo BOOLEAN_LIST.

stringValues[]

string

Valor de string repetido. Precisa ser definido se feedAttributeId se referir a um atributo de feed do tipo STRING_LIST, URL_LIST ou DATE_TIME_LIST. Para STRING_LIST e URL_LIST, o tamanho total da lista em bytes não pode exceder 3.000. Para DATE_TIME_LIST, o número de elementos não pode exceder 200.

Para STRING_LIST, o tamanho máximo de cada elemento de string é de 1.500 caracteres. Para URL_LIST, o tamanho máximo é de 2.076 caracteres. Para DATE_TIME, o formato da string precisa ser igual ao horário de início e de término do item do feed.

doubleValues[]

number

Valor duplo repetido. Precisa ser definido se feedAttributeId se referir a um atributo de feed do tipo DOUBLE_LIST.

feedAttributeId

string (int64 format)

ID do atributo do feed ao qual o valor está associado.

integerValue

string (int64 format)

Valor Int64. Precisa ser definido se feedAttributeId se referir a um atributo de feed do tipo INT64.

booleanValue

boolean

Valor bool. Precisa ser definido se feedAttributeId se referir a um atributo de feed do tipo BOOLEAN.

stringValue

string

Valor da string. Precisa ser definido se feedAttributeId se referir a um atributo de feed do tipo STRING, URL ou DATE_TIME. Para STRING, o tamanho máximo é de 1.500 caracteres. Para URL, o tamanho máximo é de 2.076 caracteres. Para DATE_TIME, a string precisa estar no formato "AAAAMMDD HHMMSS".

doubleValue

number

Valor duplo. Precisa ser definido se feedAttributeId se referir a um atributo de feed do tipo DOUBLE.

GeoTargetingRestriction

Uma restrição usada para determinar se a localização geográfica do contexto da solicitação deve ser correspondida.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
LOCATION_OF_PRESENCE Indica que o contexto da solicitação deve corresponder à localização física do usuário.

FeedItemPlaceholderPolicyInfo

Informações de política, validação e aprovação de qualidade para um item do feed para o tipo de marcador de posição especificado.

Representação JSON
{
  "placeholderTypeEnum": enum (PlaceholderType),
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus),
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "validationStatus": enum (FeedItemValidationStatus),
  "validationErrors": [
    {
      object (FeedItemValidationError)
    }
  ],
  "qualityApprovalStatus": enum (FeedItemQualityApprovalStatus),
  "qualityDisapprovalReasons": [
    enum (FeedItemQualityDisapprovalReason)
  ],
  "feedMappingResourceName": string
}
Campos
placeholderTypeEnum

enum (PlaceholderType)

Apenas saída. O tipo de marcador de posição.

reviewStatus

enum (PolicyReviewStatus)

Apenas saída. Onde o tipo de marcador de posição está no processo de revisão

approvalStatus

enum (PolicyApprovalStatus)

Apenas saída. O status geral de aprovação do tipo de marcador de posição, calculado com base no status das entradas de tópicos de política individuais.

policyTopicEntries[]

object (PolicyTopicEntry)

Apenas saída. A lista de descobertas de política para o tipo de marcador de posição.

validationStatus

enum (FeedItemValidationStatus)

Apenas saída. O status de validação do tipo de marcador de posição.

validationErrors[]

object (FeedItemValidationError)

Apenas saída. Lista de erros de validação do tipo de marcador de posição.

qualityApprovalStatus

enum (FeedItemQualityApprovalStatus)

Apenas saída. Status de aprovação da avaliação de qualidade do tipo de marcador de posição.

qualityDisapprovalReasons[]

enum (FeedItemQualityDisapprovalReason)

Apenas saída. Lista de motivos para a reprovação da avaliação de qualidade do tipo de marcador.

feedMappingResourceName

string

Apenas saída. O FeedMapping que contém o tipo de marcador de posição.

FeedItemValidationStatus

Os possíveis status de validação de um item do feed.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
PENDING Validação pendente.
INVALID Um erro foi encontrado.
VALID O item do feed tem uma boa formatação do feed.

FeedItemValidationError

Armazena um erro de validação e o conjunto de atributos do feed ofensivos que juntos são responsáveis por causar um erro de validação do item do feed.

Representação JSON
{
  "validationError": enum (FeedItemValidationError),
  "feedAttributeIds": [
    string
  ],
  "description": string,
  "extraInfo": string
}
Campos
validationError

enum (FeedItemValidationError)

Apenas saída. Código do erro indicando qual erro de validação foi acionado. Confira a descrição do erro no campo "description".

feedAttributeIds[]

string (int64 format)

Apenas saída. Conjunto de atributos no item do feed sinalizados durante a validação. Se estiver vazio, nenhum atributo de feed específico poderá ser associado ao erro (por exemplo, em todo o item do feed).

description

string

Apenas saída. A descrição do erro de validação.

extraInfo

string

Apenas saída. Informações adicionais relacionadas a esse erro que não são capturadas por validateError e feedAttributeId. Por exemplo, IDs de campo de marcador de posição quando feedAttributeId não está mapeado. O extraInfo não está localizado.

FeedItemValidationError

Os possíveis erros de validação de um item do feed.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
STRING_TOO_SHORT A string é muito curta.
STRING_TOO_LONG A string é muito longa.
VALUE_NOT_SPECIFIED O valor não é fornecido.
INVALID_DOMESTIC_PHONE_NUMBER_FORMAT O formato do número de telefone é inválido para a região.
INVALID_PHONE_NUMBER A string não representa um número de telefone.
PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY O formato do número de telefone não é compatível com o código do país.
PREMIUM_RATE_NUMBER_NOT_ALLOWED O número da taxa premium não é permitido.
DISALLOWED_NUMBER_TYPE Tipo de número de telefone não permitido.
VALUE_OUT_OF_RANGE O valor especificado está fora do intervalo válido.
CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY O acompanhamento de chamadas não é compatível com o país selecionado.
CUSTOMER_NOT_IN_ALLOWLIST_FOR_CALLTRACKING O cliente não está na lista de permissões do acompanhamento de chamadas.
INVALID_COUNTRY_CODE O código do país é inválido.
INVALID_APP_ID O ID do app para dispositivos móveis especificado é inválido.
MISSING_ATTRIBUTES_FOR_FIELDS Alguns atributos de campo obrigatórios estão ausentes.
INVALID_TYPE_ID Tipo de botão de e-mail inválido para a extensão de e-mail.
INVALID_EMAIL_ADDRESS Endereço de e-mail inválido.
INVALID_HTTPS_URL O URL HTTPS na extensão de e-mail é inválido.
MISSING_DELIVERY_ADDRESS O endereço de entrega está ausente na extensão de e-mail.
START_DATE_AFTER_END_DATE A data de início da programação do item de feed vem após a data de término.
MISSING_FEED_ITEM_START_TIME O horário de início da programação do item de feed está ausente.
MISSING_FEED_ITEM_END_TIME O horário de término da programação do item de feed está ausente.
MISSING_FEED_ITEM_ID Não é possível computar os atributos do sistema em um item de feed que não tem um ID de item.
VANITY_PHONE_NUMBER_NOT_ALLOWED Os números de telefone alfabéticos da extensão de chamada não são compatíveis.
INVALID_REVIEW_EXTENSION_SNIPPET Texto da revisão inválido.
INVALID_NUMBER_FORMAT Formato inválido para o valor numérico no parâmetro do anúncio.
INVALID_DATE_FORMAT Formato inválido para o valor de data no parâmetro do anúncio.
INVALID_PRICE_FORMAT Formato inválido para o valor do preço no parâmetro do anúncio.
UNKNOWN_PLACEHOLDER_FIELD O tipo fornecido para o valor no parâmetro do anúncio não é reconhecido.
REVIEW_EXTENSION_SOURCE_INELIGIBLE A origem da revisão não é qualificada.
HYPHENS_IN_REVIEW_EXTENSION_SNIPPET O texto da revisão não pode conter hifens ou traços.
DOUBLE_QUOTES_IN_REVIEW_EXTENSION_SNIPPET O texto da revisão não pode conter aspas duplas.
QUOTES_IN_REVIEW_EXTENSION_SNIPPET O texto da revisão não pode conter aspas.
INVALID_FORM_ENCODED_PARAMS Os parâmetros estão codificados no formato errado.
INVALID_URL_PARAMETER_NAME O nome do parâmetro de URL precisa conter somente letras, números, sublinhados e traços.
NO_GEOCODING_RESULT Não é possível encontrar o local do endereço.
SOURCE_NAME_IN_REVIEW_EXTENSION_TEXT O texto da extensão de comentários tem o nome da origem.
CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED Alguns números de telefone podem ficar mais curtos do que o normal. Alguns desses números curtos são específicos das operadoras. Por isso, não permitimos a inclusão deles em extensões de anúncio, porque eles não estão disponíveis para todos os usuários.
INVALID_PLACEHOLDER_FIELD_ID Acionado quando uma solicitação faz referência a um ID de campo de marcador que não existe.
INVALID_URL_TAG O URL contém tags ou formato ValueTrack inválidos.
LIST_TOO_LONG A lista fornecida excede o tamanho aceitável.
INVALID_ATTRIBUTES_COMBINATION Não é permitido especificar determinadas combinações de atributos no mesmo item do feed.
DUPLICATE_VALUES Um atributo tem o mesmo valor repetidamente.
INVALID_CALL_CONVERSION_ACTION_ID Os anunciantes podem vincular uma ação de conversão a um número de telefone para indicar que chamadas longas suficientes encaminhadas para esse número devem ser contabilizadas como conversões do tipo especificado. Essa é uma mensagem de erro que indica que a ação de conversão especificada é inválida. Por exemplo, a ação de conversão não existe na conta apropriada do Google Ads ou é um tipo de conversão inadequado para conversões de chamada.
CANNOT_SET_WITHOUT_FINAL_URLS O modelo de acompanhamento requer a definição de um URL final.
APP_ID_DOESNT_EXIST_IN_APP_STORE Foi fornecido um ID de aplicativo que não existe na app store em questão.
INVALID_FINAL_URL URL final de U2 inválido.
INVALID_TRACKING_URL URL de monitoramento de U2 inválido.
INVALID_FINAL_URL_FOR_APP_DOWNLOAD_URL O URL final deve começar a partir do URL de download do aplicativo.
LIST_TOO_SHORT A lista fornecida é muito curta.
INVALID_USER_ACTION O campo "Ação do usuário" tem um valor inválido.
INVALID_TYPE_NAME O campo "Tipo" tem um valor inválido.
INVALID_EVENT_CHANGE_STATUS O status de alteração do evento é inválido.
INVALID_SNIPPETS_HEADER O cabeçalho de uma extensão de snippets estruturados não é válido.
NUMBER_TYPE_WITH_CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY Número de telefone incompatível com o acompanhamento de chamadas do país.
RESERVED_KEYWORD_OTHER A entrada é idêntica a uma palavra-chave reservada
DUPLICATE_OPTION_LABELS Cada marcador de opção na extensão da mensagem precisa ser exclusivo.
DUPLICATE_OPTION_PREFILLS Cada opção de preenchimento automático na extensão da mensagem precisa ser exclusiva.
UNEQUAL_LIST_LENGTHS Nas extensões de mensagem, o número de marcadores e preenchimentos opcionais precisa ser o mesmo.
INCONSISTENT_CURRENCY_CODES Todos os códigos de moeda em uma extensão de anúncio devem ser os mesmos.
PRICE_EXTENSION_HAS_DUPLICATED_HEADERS Os cabeçalhos na extensão de preço não são exclusivos.
ITEM_HAS_DUPLICATED_HEADER_AND_DESCRIPTION O cabeçalho e a descrição de um item são iguais.
PRICE_EXTENSION_HAS_TOO_FEW_ITEMS A extensão de preço tem poucos itens.
UNSUPPORTED_VALUE O valor fornecido não é compatível.
INVALID_FINAL_MOBILE_URL URL final para dispositivos móveis inválido.
INVALID_KEYWORDLESS_AD_RULE_LABEL O valor de string fornecido para o rótulo contém caracteres inválidos
VALUE_TRACK_PARAMETER_NOT_SUPPORTED O URL fornecido contém parâmetros de acompanhamento de valor.
UNSUPPORTED_VALUE_IN_SELECTED_LANGUAGE O valor fornecido não é compatível com o idioma selecionado de uma extensão.
PROMOTION_INVALID_TIME O horário da promoção é inválido.
PROMOTION_CANNOT_SET_PERCENT_OFF_AND_MONEY_AMOUNT_OFF Os campos de porcentagem e valor do desconto estão definidos.
PROMOTION_CANNOT_SET_PROMOTION_CODE_AND_ORDERS_OVER_AMOUNT Os campos de código promocional e pedidos acima de valor estão definidos.
TOO_MANY_DECIMAL_PLACES_SPECIFIED Muitas casas decimais foram especificadas.
AD_CUSTOMIZERS_NOT_ALLOWED Os personalizadores de anúncios estão presentes e não são permitidos.
INVALID_LANGUAGE_CODE O código do idioma não é válido.
UNSUPPORTED_LANGUAGE O idioma não é compatível.
IF_FUNCTION_NOT_ALLOWED A função IF está presente e não é permitida.
INVALID_FINAL_URL_SUFFIX O sufixo do URL final não é válido.
INVALID_TAG_IN_FINAL_URL_SUFFIX O sufixo do URL final contém uma tag inválida.
INVALID_FINAL_URL_SUFFIX_FORMAT O sufixo do URL final está formatado incorretamente.
ONLY_ONE_DELIVERY_OPTION_IS_ALLOWED Várias opções de entrega de mensagem estão definidas.
NO_DELIVERY_OPTION_IS_SET Nenhuma opção de entrega de mensagem foi definida.
INVALID_CONVERSION_REPORTING_STATE O valor da string do campo de estado do relatório de conversão não é válido.
IMAGE_SIZE_WRONG O tamanho da imagem não está certo.
EMAIL_DELIVERY_NOT_AVAILABLE_IN_COUNTRY A entrega de e-mails não está disponível no país especificado no campo de código de país.
AUTO_REPLY_NOT_AVAILABLE_IN_COUNTRY A resposta automática não está disponível no país especificado no campo de código de país.
INVALID_LATITUDE_VALUE O valor especificado para a latitude é inválido.
INVALID_LONGITUDE_VALUE O valor especificado para a longitude é inválido.
TOO_MANY_LABELS Foram fornecidas muitas etiquetas.
INVALID_IMAGE_URL O URL da imagem é inválido.
MISSING_LATITUDE_VALUE O valor de latitude está ausente.
MISSING_LONGITUDE_VALUE O valor de longitude está ausente.
ADDRESS_NOT_FOUND Não foi possível encontrar o endereço.
ADDRESS_NOT_TARGETABLE Não é possível segmentar o endereço fornecido.
INVALID_ASSET_ID O ID do recurso especificado não existe.
INCOMPATIBLE_ASSET_TYPE O tipo de recurso não pode ser definido para o campo.
IMAGE_ERROR_UNEXPECTED_SIZE A imagem tem um tamanho inesperado.
IMAGE_ERROR_ASPECT_RATIO_NOT_ALLOWED A proporção da imagem não é permitida.
IMAGE_ERROR_FILE_TOO_LARGE O arquivo de imagem é muito grande.
IMAGE_ERROR_FORMAT_NOT_ALLOWED O formato da imagem não é aceito.
IMAGE_ERROR_CONSTRAINTS_VIOLATED A imagem viola as restrições sem mais detalhes.
IMAGE_ERROR_SERVER_ERROR Ocorreu um erro ao validar a imagem.

FeedItemQualityApprovalStatus

Os possíveis status de aprovação da avaliação de qualidade de um item do feed.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
APPROVED Atende a todas as expectativas de qualidade.
DISAPPROVED Não atende a algumas expectativas de qualidade. O motivo específico pode ser encontrado no campoqualityDisapprovalReasons.

FeedItemQualityDisapprovalReason

Os possíveis motivos de reprovação de um item do feed na avaliação de qualidade.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
PRICE_TABLE_REPETITIVE_HEADERS O preço contém cabeçalhos repetitivos.
PRICE_TABLE_REPETITIVE_DESCRIPTION O preço contém descrições repetitivas.
PRICE_TABLE_INCONSISTENT_ROWS O preço contém itens inconsistentes.
PRICE_DESCRIPTION_HAS_PRICE_QUALIFIERS O preço contém qualificadores na descrição.
PRICE_UNSUPPORTED_LANGUAGE O preço contém um idioma sem suporte.
PRICE_TABLE_ROW_HEADER_TABLE_TYPE_MISMATCH O cabeçalho do item de preço não é relevante para o tipo de preço.
PRICE_TABLE_ROW_HEADER_HAS_PROMOTIONAL_TEXT O cabeçalho do item de preço contém texto promocional.
PRICE_TABLE_ROW_DESCRIPTION_NOT_RELEVANT A descrição do item de preço não é relevante para o cabeçalho do item.
PRICE_TABLE_ROW_DESCRIPTION_HAS_PROMOTIONAL_TEXT A descrição do item de preço contém texto promocional.
PRICE_TABLE_ROW_HEADER_DESCRIPTION_REPETITIVE O cabeçalho e a descrição do item de preço são repetitivos.
PRICE_TABLE_ROW_UNRATEABLE O item de preço está em um idioma estrangeiro, não faz sentido ou não pode ser classificado.
PRICE_TABLE_ROW_PRICE_INVALID O preço do item de preço é inválido ou impreciso.
PRICE_TABLE_ROW_URL_INVALID O URL do item de preço é inválido ou irrelevante.
PRICE_HEADER_OR_DESCRIPTION_HAS_PRICE O cabeçalho ou a descrição do item de preço contém um preço.
STRUCTURED_SNIPPETS_HEADER_POLICY_VIOLATED Os valores do snippet estruturado não correspondem ao cabeçalho.
STRUCTURED_SNIPPETS_REPEATED_VALUES Os valores do snippet estruturado são repetidos.
STRUCTURED_SNIPPETS_EDITORIAL_GUIDELINES Os valores do snippet estruturado violam as diretrizes editoriais, como a pontuação.
STRUCTURED_SNIPPETS_HAS_PROMOTIONAL_TEXT O snippet estruturado contém texto promocional.