REST Resource: availabilityOrders.availabilityLines

Ressource: AvailabilityLine

Une ligne de disponibilité représente un ensemble de paramètres pour lesquels l'acheteur demande la disponibilité de l'inventaire ainsi que la réponse du vendeur. Pour connaître le workflow, consultez AvailabilityOrder.

Représentation JSON 
{
  "name": string,
  "product": string,
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "targeting": {
    object (Targeting)
  },
  "availabilityLineTerms": {
    object (LineTerms)
  },
  "state": enum (State),
  "rejection": {
    object (Rejection)
  },
  "createTime": string,
  "updateTime": string
}
Champs
name

string

Uniquement en sortie. Nom de ressource de la ligne de disponibilité au format availabilityOrders/123/availabilityLines/321.
product

string

Uniquement en sortie. Nom de l'entité (Product) concernée par cette demande de disponibilité. Format = products/456
startTime
(deprecated)

string (Timestamp format)

Uniquement en sortie. Heure de début à laquelle la disponibilité est demandée (incluse).

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
endTime
(deprecated)

string (Timestamp format)

Uniquement en sortie. Heure de fin du moment où la disponibilité est demandée (exclusive).

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
startDate

object (Date)

Uniquement en sortie. Date de début du moment où la disponibilité est demandée (incluse). Même fuseau horaire que celui du bloc d'annonces.
endDate

object (Date)

Uniquement en sortie. Date de fin de la demande de disponibilité (incluse). Même fuseau horaire que celui du bloc d'annonces.
budget

object (Money)

Uniquement en sortie. Budget de la ligne de disponibilité.
targeting

object (Targeting)

Uniquement en sortie. Ciblage pour lequel la disponibilité est demandée.
availabilityLineTerms

object (LineTerms)

Uniquement en sortie. Le vendeur peut utiliser [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] pour mettre à jour les [LineTerms].
state

enum (State)

Uniquement en sortie. État de cette commande de disponibilité. Consultez AvailabilityLine.State pour connaître le cycle de vie d'une ligne de disponibilité.

Le vendeur peut utiliser les méthodes personnalisées [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] ou [Dismiss][google.ads.xbid.outofhome.v1beta1.OrderManagementService.DenyAvailabilityLine] pour définir l'une des méthodes suivantes:

  • STATE_COMPLETED
  • STATE_REJECTED

respectivement.
rejection

object (Rejection)

Détails du refus pour la ligne de disponibilité.
createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de création de la ligne de disponibilité.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière mise à jour pour la ligne de disponibilité.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

État

Valeurs possibles pour l'état de la ligne de disponibilité.

Enums
STATE_UNSPECIFIED Valeur par défaut lorsque l'état de la ligne de disponibilité n'a pas été spécifié ou est inconnu dans cette version.
STATE_PENDING Disponibilité en attente lorsque l'acheteur a défini les paramètres de la demande de disponibilité.
STATE_COMPLETED État "Terminé" lorsque le vendeur a fourni la réponse de disponibilité.
STATE_REJECTED État de refus lorsque la limite de disponibilité a été refusée par le vendeur. Vous devez fournir les détails du refus.
STATE_CANCELLED État "Annulé" lorsque l'acheteur annule la commande avant que le vendeur n'ait terminé ou refuse la réponse concernant la disponibilité.

Méthodes

complete

 Marque une ligne de disponibilité existante comme terminée.

get

 Récupère une ligne individuelle pour une commande de disponibilité.

list

 Répertorie les lignes d'une commande de disponibilité.

reject

 Marque une ligne de disponibilité existante comme refusée.