BillingSetup

Une configuration de facturation qui associe un compte de paiement et un annonceur Une configuration de facturation est spécifique à un seul annonceur.

Représentation JSON 
{
  "resourceName": string,
  "status": enum (BillingSetupStatus),
  "paymentsAccountInfo": {
    object (PaymentsAccountInfo)
  },
  "id": string,
  "paymentsAccount": string,

  // Union field start_time can be only one of the following:
  "startDateTime": string,
  "startTimeType": enum (TimeType)
  // End of list of possible types for union field start_time.

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.
}
Champs
resourceName

string

Immuable. Nom de ressource de la configuration de facturation. Les noms de ressources BillingSetup se présentent au format suivant:

customers/{customerId}/billingSetups/{billing_setup_id}
status

enum (BillingSetupStatus)

Uniquement en sortie. État de la configuration de la facturation.
paymentsAccountInfo

object (PaymentsAccountInfo)

Immuable. Il s'agit des informations du compte de paiement associées à cette configuration de facturation. Lors de la configuration de la facturation, celle-ci permet de s'inscrire avec un nouveau compte de paiement. Notez que cette option ne doit pas être définie. Lors de la configuration de la facturation, ce compte et le compte de paiement seront renseignés.
id

string (int64 format)

Uniquement en sortie. ID de la configuration de facturation.
paymentsAccount

string

Immuable. Nom de ressource du compte de paiement associé à cette configuration de facturation. Le nom des ressources de paiement se présente sous la forme suivante:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} Lors de la configuration de la facturation, ces informations permettent de s'inscrire avec un compte de paiement existant (et les informations paymentsAccountInfo ne doivent pas être définies). Lors de la configuration de la facturation, ces informations ainsi que celles de paymentsAccountInfo seront renseignées.

Champ d'union start_time. Lorsque vous créez une configuration de facturation, c'est à ce moment-là qu'elle doit prendre effet. Si le client n'a pas de configuration approuvée, le seul moment de début autorisé est MAINTENANT.

Lors de la récupération d'une configuration de facturation existante, il s'agit de l'heure de début demandée. Toutefois, si la configuration a été approuvée (voir l'état) après l'heure de début demandée, il s'agit de l'heure d'approbation. start_time ne peut être qu'un des éléments suivants :
startDateTime

string

Immuable. Date et heure de début au format aaaa-MM-jj ou aaaa-MM-jj HH:mm:ss. Seule une heure située dans le futur est autorisée.
startTimeType

enum (TimeType)

Immuable. Heure de début, sous forme de type. Seul NOW est autorisé.
Champ d'union end_time. Indique la date et l'heure de fin de la configuration de la facturation. Il s'agit de l'heure de début de la prochaine configuration de facturation planifiée. end_time ne peut être qu'un des éléments suivants :
endDateTime

string

Uniquement en sortie. Date et heure de fin au format aaaa-MM-jj ou aaaa-MM-jj HH:mm:ss.
endTimeType

enum (TimeType)

Uniquement en sortie. Heure de fin, sous forme de type. La seule valeur possible est FOREVER.

BillingSetupStatus

États possibles d'un BillingSetup.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
PENDING La configuration de facturation est en attente d'approbation.
APPROVED_HELD La configuration de facturation a été approuvée, mais pas le premier budget correspondant. Cela ne peut se produire que pour les configurations de facturation configurées pour la facturation mensuelle.
APPROVED La configuration de facturation a été approuvée.
CANCELLED La configuration de facturation a été annulée par l'utilisateur avant l'approbation.

PaymentsAccountInfo

Conteneur des informations du compte de paiement pour cette facturation.

Représentation JSON 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
Champs
paymentsAccountId

string

Uniquement en sortie. Identifiant à 16 chiffres permettant d'identifier le compte de paiement associé à la configuration de facturation.

Il doit être transmis sous la forme d'une chaîne avec des tirets (par exemple, "1234-5678-9012-3456").
paymentsAccountName

string

Immuable. Nom du compte de paiement associé à la configuration de la facturation.

Cela permet à l'utilisateur de saisir un nom explicite pour le compte de paiement afin de faciliter le rapprochement des factures mensuelles.

Ce nom sera imprimé sur les factures mensuelles.
paymentsProfileId

string

Immuable. Identifiant à 12 chiffres permettant d'identifier le profil de paiement associé à la configuration de facturation.

Il doit être transmis sous la forme d'une chaîne avec des tirets (par exemple, "1234-5678-9012").
paymentsProfileName

string

Uniquement en sortie. Nom du profil de paiement associé à la configuration de la facturation.
secondaryPaymentsProfileId

string

Uniquement en sortie. ID de profil de paiement secondaire présent dans des situations peu courantes, par exemple lorsqu'un accord de responsabilité séquentielle a été conclu.