Feed

Un flux.

Représentation 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.
}
Champs
resourceName

string

Immuable. Nom de ressource du flux. Le format des noms de ressources de flux est le suivant:

customers/{customerId}/feeds/{feedId}

attributes[]

object (FeedAttribute)

Attributs du flux Obligatoire lors de la phase "CREATE", sauf si "system_feed_generation_data" est fourni. Dans ce cas, Google Ads mettra à jour le flux avec les attributs appropriés. Interdiction lors de la mise à jour (UPDATE). Utilisez attributeOperations pour ajouter de nouveaux attributs.

attributeOperations[]

object (FeedAttributeOperation)

Liste des opérations modifiant les attributs du flux. Vous pouvez uniquement ajouter des attributs, mais pas les supprimer.

origin

enum (FeedOrigin)

Immuable. Indique qui gère les "FeedAttributes" du flux.

status

enum (FeedStatus)

Uniquement en sortie. État du flux. Ce champ est en lecture seule.

id

string (int64 format)

Uniquement en sortie. ID du flux. Ce champ est en lecture seule.

name

string

Immuable. Nom du flux. Obligatoire.

Champ d'union system_feed_generation_data. Données système pour le flux. Ces données spécifient les informations permettant de générer les éléments du flux généré par le système. system_feed_generation_data ne peut être qu'un des éléments suivants :
placesLocationFeedData

object (PlacesLocationFeedData)

Données utilisées pour configurer un flux d'établissements généré à partir de la fiche d'établissement.

affiliateLocationFeedData

object (AffiliateLocationFeedData)

Données utilisées pour configurer un flux de lieux affilié contenant les chaînes spécifiées.

FeedAttribute

Les attributs "FeedAttribute" définissent les types de données devant figurer dans chaque flux. Un seul "FeedAttribute" spécifie le type attendu de "FeedItemAttributes", avec le même "FeedAttributeId". Vous pouvez également marquer un objet "FeedAttribute" comme faisant partie de la clé unique d'un élément "FeedItem".

Représentation JSON
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
Champs
type

enum (FeedAttributeType)

Type de données de l'attribut de flux. Obligatoire.

id

string (int64 format)

Identifiant de l'attribut.

name

string

Nom de l'attribut. Obligatoire.

isPartOfKey

boolean

Indique que les données correspondant à cet attribut font partie de la clé unique d'un élément de flux. Si aucune valeur n'est spécifiée, la valeur par défaut est "false". Notez qu'une clé unique n'est pas nécessaire dans le schéma d'un flux. Dans ce cas, les éléments de flux doivent être référencés par leur identifiant feed_item_id.

FeedAttributeType

Types de données possibles pour un attribut de flux.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
INT64 Int64
DOUBLE Double.
STRING Chaîne.
BOOLEAN Valeur booléenne.
URL URL.
DATE_TIME Date et heure.
INT64_LIST Liste Int64.
DOUBLE_LIST Liste double (8 octets).
STRING_LIST Liste de chaînes.
BOOLEAN_LIST Liste booléenne.
URL_LIST Liste d'URL.
DATE_TIME_LIST Liste "Date/Heure".
PRICE Prix

FeedAttributeOperation

Opération à effectuer sur une liste d'attributs de flux dans une opération mutate.

Représentation JSON
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
Champs
operator

enum (Operator)

Uniquement en sortie. Type d'opération de liste à effectuer.

value

object (FeedAttribute)

Uniquement en sortie. Attribut de flux ajouté à la liste.

Opérateur

L'opérateur.

Enums
UNSPECIFIED URL indéterminée.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ADD Ajoutez l'attribut aux attributs existants.

FeedOrigin

Valeurs possibles pour l'origine d'un flux.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
USER Les attributs "FeedAttributes" de ce flux sont gérés par l'utilisateur. Les utilisateurs peuvent ajouter des "FeedAttributes" à ce flux.
GOOGLE Les "FeedAttributes" d'un flux GOOGLE sont créés par Google. Un flux de ce type est géré par Google et possède les attributs appropriés pour le type d'espace réservé du flux.

FeedStatus

États possibles d'un flux.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED Le flux est activé.
REMOVED Le flux a été supprimé.

PlacesLocationFeedData

Données utilisées pour configurer un flux d'établissements généré à partir de la fiche d'établissement.

Représentation JSON
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
Champs
oauthInfo

object (OAuthInfo)

Immuable. Jeton d'authentification requis (provenant de l'API OAuth) pour l'e-mail. Ce champ ne peut être spécifié que dans une requête de création. Aucun de ses sous-champs ne peut être sélectionné.

businessAccountId

string

ID de la page Google+ de l'entreprise gérée dont les établissements doivent être utilisés. Si ce champ n'est pas défini, tous les établissements auxquels l'utilisateur peut accéder (spécifiés dans le champ "emailAddress") sont utilisés. Ce champ est mutate-uniquement et ne peut pas être sélectionné.

categoryFilters[]

string

Permet de filtrer les fiches d'établissement par catégories. Si des entrées existent dans categoryFilters, seules les fiches appartenant à l'une des catégories peuvent être synchronisées dans FeedItems. Si aucune entrée n'existe dans categoryFilters, toutes les fiches peuvent être synchronisées.

labelFilters[]

string

Permet de filtrer les fiches d'établissement en fonction des libellés. Si des entrées existent dans labelFilters, seules les fiches associées à l'un des libellés définis peuvent être synchronisées dans FeedItems. Si aucune entrée n'existe dans labelFilters, toutes les fiches peuvent être synchronisées.

emailAddress

string

Adresse e-mail d'une fiche d'établissement ou adresse e-mail d'un administrateur de la fiche. Obligatoire.

businessNameFilter

string

Permet de filtrer les fiches d'établissement par nom d'entreprise. Si businessNameFilter est défini, seules les fiches dont le nom d'entreprise correspond peuvent être synchronisées avec FeedItems.

OAuthInfo

Données utilisées pour l'autorisation via OAuth.

Représentation JSON
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
Champs
httpMethod

string

Méthode HTTP utilisée pour obtenir l'autorisation.

httpRequestUrl

string

URL de requête HTTP utilisée pour obtenir l'autorisation.

httpAuthorizationHeader

string

En-tête d'autorisation HTTP utilisé pour obtenir l'autorisation.

AffiliateLocationFeedData

Données utilisées pour configurer un flux de lieux affilié contenant les chaînes spécifiées.

Représentation JSON
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
Champs
chainIds[]

string (int64 format)

Liste des chaînes à partir desquelles le flux de lieux affilié sera synchronisé.

relationshipType

enum (AffiliateLocationFeedRelationshipType)

Relation entre les chaînes et l'annonceur.

AffiliateLocationFeedRelationshipType

Valeurs possibles d'un type de relation pour un flux de lieux affilié.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
GENERAL_RETAILER Relation générale avec le marchand.