Feed

Un feed.

Rappresentazione 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.
}
Campi
resourceName

string

Immutabile. Il nome della risorsa del feed. I nomi delle risorse del feed hanno il seguente formato:

customers/{customerId}/feeds/{feedId}

attributes[]

object (FeedAttribute)

Gli attributi del Feed. Obbligatorio il giorno CREATE, a meno che non venga fornito system_feed_generation_data, nel qual caso Google Ads aggiornerà il feed con gli attributi corretti. Non consentita il giorno UPDATE. Utilizza attributeOperations per aggiungere nuovi attributi.

attributeOperations[]

object (FeedAttributeOperation)

L'elenco delle operazioni che modificano gli attributi del feed. Gli attributi possono essere solo aggiunti, non rimossi.

origin

enum (FeedOrigin)

Immutabile. Specifica chi gestisce gli attributi del feed per il feed.

status

enum (FeedStatus)

Solo output. Lo stato del feed. Questo campo è di sola lettura.

id

string (int64 format)

Solo output. L'ID del feed. Questo campo è di sola lettura.

name

string

Immutabile. Nome del feed. Obbligatorio.

Campo di unione system_feed_generation_data. I dati di sistema per il Feed. Questi dati specificano le informazioni per generare gli elementi del feed generato dal sistema. system_feed_generation_data può essere solo uno dei seguenti:
placesLocationFeedData

object (PlacesLocationFeedData)

Dati utilizzati per configurare un feed di località completato da Profilo dell'attività.

affiliateLocationFeedData

object (AffiliateLocationFeedData)

Dati utilizzati per configurare un feed di località dell'affiliato completato con le catene specificate.

FeedAttribute

FeedAttributes definisce i tipi di dati che dovrebbero essere presenti in un Feed. Un singolo FeedAttribute specifica il tipo previsto di FeedItemAttributes con lo stesso FeedAttributeId. Facoltativamente, un FeedAttribute può essere contrassegnato come parte della chiave univoca di un FeedItem.

Rappresentazione JSON
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
Campi
type

enum (FeedAttributeType)

Tipo di dati per l'attributo del feed. Obbligatorio.

id

string (int64 format)

ID dell'attributo.

name

string

Il nome dell'attributo. Obbligatorio.

isPartOfKey

boolean

Indica che i dati corrispondenti a questo attributo fanno parte della chiave univoca di un elemento del feed. Il valore predefinito è false se non è specificato. Tieni presente che non è necessaria una chiave univoca nello schema di un feed, nel qual caso gli elementi del feed devono essere indicati tramite il rispettivo feed_item_id.

FeedAttributeType

Possibili tipi di dati per un attributo del feed.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
INT64 Int64.
DOUBLE Doppio.
STRING Stringa.
BOOLEAN Booleano.
URL URL.
DATE_TIME Data/ora.
INT64_LIST Elenco int64.
DOUBLE_LIST Elenco doppio (8 byte).
STRING_LIST Elenco di stringhe.
BOOLEAN_LIST Elenco booleano.
URL_LIST Elenco URL.
DATE_TIME_LIST Elenco date/ore.
PRICE Prezzo.

FeedAttributeOperation

Operazione da eseguire su un elenco di attributi del feed in una modifica.

Rappresentazione JSON
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
Campi
operator

enum (Operator)

Solo output. Tipo di operazione sull'elenco da eseguire.

value

object (FeedAttribute)

Solo output. L'attributo del feed che viene aggiunto all'elenco.

Operatore

L'operatore.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
ADD Aggiungi l'attributo agli attributi esistenti.

FeedOrigin

Valori possibili per un'origine del feed.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
USER Gli attributi del feed per questo feed sono gestiti dall'utente. Gli utenti possono aggiungere FeedAttributes a questo Feed.
GOOGLE FeedAttributes per un feed GOOGLE sono creati da Google. Un feed di questo tipo è gestito da Google e avrà gli attributi corretti per il tipo di segnaposto del feed.

FeedStatus

Possibili stati di un feed.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
ENABLED Il feed è attivato.
REMOVED Il feed è stato rimosso.

PlacesLocationFeedData

Dati utilizzati per configurare un feed di località completato da Profilo dell'attività.

Rappresentazione JSON
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
Campi
oauthInfo

object (OAuthInfo)

Immutabile. Token di autenticazione obbligatorio (dall'API OAuth) per l'email. Questo campo può essere specificato solo in una richiesta di creazione. Tutti i relativi campi secondari non sono selezionabili.

businessAccountId

string

ID pagina Google+ dell'attività gestita di cui devono essere utilizzate le sedi. Se questo campo non viene impostato, vengono utilizzate tutte le attività accessibili dall'utente (specificate da emailAddress). Questo campo è solo mutate e non è selezionabile.

categoryFilters[]

string

Utilizzato per filtrare le schede del profilo dell'attività per categorie. Se i filtri della categoria sono presenti, solo le schede che appartengono a una qualsiasi delle categorie possono essere sincronizzate in FeedItems. Se non esistono voci in categoryFiltri, tutte le schede sono candidati per la sincronizzazione.

labelFilters[]

string

Utilizzato per filtrare le schede del profilo dell'attività in base alle etichette. Se sono presenti voci in labelFiltri, solo le schede con una qualsiasi delle etichette impostate possono essere sincronizzate in FeedItems. Se in labelFiltri non sono presenti voci, tutti gli elenchi sono candidati per la sincronizzazione.

emailAddress

string

Indirizzo email di un profilo dell'attività o indirizzo email di un gestore del profilo dell'attività. Obbligatorio.

businessNameFilter

string

Utilizzato per filtrare le schede del profilo dell'attività in base al nome dell'attività. Se l'impostazione businessNameFilter, è possibile sincronizzare solo le schede con un nome dell'attività corrispondente agli elementi del feed.

OAuthInfo

Dati utilizzati per l'autorizzazione tramite OAuth.

Rappresentazione JSON
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
Campi
httpMethod

string

Il metodo HTTP utilizzato per ottenere l'autorizzazione.

httpRequestUrl

string

L'URL della richiesta HTTP utilizzato per ottenere l'autorizzazione.

httpAuthorizationHeader

string

L'intestazione di autorizzazione HTTP utilizzata per ottenere l'autorizzazione.

AffiliateLocationFeedData

Dati utilizzati per configurare un feed di località dell'affiliato completato con le catene specificate.

Rappresentazione JSON
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
Campi
chainIds[]

string (int64 format)

L'elenco di catene da cui il feed delle località dell'affiliato sincronizzerà le sedi.

relationshipType

enum (AffiliateLocationFeedRelationshipType)

La relazione che le catene hanno con l'inserzionista.

AffiliateLocationFeedRelationshipType

Valori possibili per un tipo di relazione per un feed di località dell'affiliato.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
GENERAL_RETAILER Rapporto generale con il rivenditore.