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 nom des ressources de flux se présente sous la forme suivante:

customers/{customerId}/feeds/{feedId}

attributes[]

object (FeedAttribute)

Attributs du flux Obligatoire lors de la création (CREATE, sauf si system_feed_generation_data est fourni), auquel cas Google Ads mettra à jour le flux avec les attributs appropriés. Non autorisé le 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. Spécifie 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 du flux. Ces données contiennent 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 d'une fiche d'établissement.

affiliateLocationFeedData

object (AffiliateLocationFeedData)

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

FeedAttribute

Les attributs "FeedAttribute" définissent les types de données susceptibles d'être présents dans un flux. Un seul "FeedAttribute" spécifie le type attendu pour "FeedItemAttributes" avec le même "FeedAttributeId". Si vous le souhaitez, vous pouvez 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 que le schéma d'un flux ne requiert pas de clé unique. Dans ce cas, les éléments de flux doivent être référencés à l'aide de 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 via 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 une origine de 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 "FeedAttribute" de ce flux sont gérés par l'utilisateur. Les utilisateurs peuvent ajouter des FeedAttributes à ce flux.
GOOGLE Les attributs "FeedAttribute" d'un flux GOOGLE sont créés par Google. Un flux de ce type est géré par Google et comporte 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 d'une 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. Vous ne pouvez pas sélectionner tous ses sous-champs.

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 par 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égorie. Si des entrées existent dans categoryFilters, seules les fiches appartenant à l'une des catégories sont candidates pour être synchronisées avec 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 par libellé. 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 d'établissement. 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 correspond à l'entreprise peuvent être synchronisées dans 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és 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és synchronisera les établissements.

relationshipType

enum (AffiliateLocationFeedRelationshipType)

La relation entre les chaînes et l'annonceur.

AffiliateLocationFeedRelationshipType

Valeurs possibles pour un type de relation dans un flux de lieux affiliés.

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 revendeur.