BillingSetup

Configuration de facturation qui associe un compte de paiement et un annonceur. Une configuration de facturation est spécifique à un 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 sous la forme suivante :

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

enum (BillingSetupStatus)

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

object (PaymentsAccountInfo)

Immuable. Informations sur le compte de paiement associé à cette configuration de facturation. Lors de la configuration de la facturation, cet identifiant est utilisé pour l'inscription à un nouveau compte de paiement. Notez que le compte paymentsAccount ne doit pas être défini. Lors de la configuration de la facturation, ces deux champs seront renseignés.
id

string (int64 format)

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

string

Immuable. Nom de la ressource du compte de paiement associé à cette configuration de facturation. Les noms des ressources de paiement sont au format suivant :

customers/{customerId}/paymentsAccounts/{paymentsAccountId} Lors de la configuration de la facturation, ce paramètre permet de s'inscrire avec un compte de paiement existant (paymentsAccountInfo ne doit donc pas être défini). Lors de l'obtention d'une configuration de facturation, ce champ et le champ paymentsAccountInfo seront renseignés.

Champ d'union start_time. Lorsque vous créez une configuration de facturation, c'est à cette date qu'elle doit prendre effet. MAINTENANT est la seule heure de début acceptable si le client n'a pas de configuration approuvée.

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, c'est l'heure d'approbation qui s'affiche. 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 date future est autorisée.
startTimeType

enum (TimeType)

Immuable. Heure de début en tant que type. Seul NOW est autorisé.
Champ d'union end_time. Date de fin de la configuration de la facturation. Il s'agit de "FOREVER" (POUR TOUJOURS) ou 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 en tant que 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 la valeur inconnue dans cette version.
PENDING La configuration de la facturation est en attente d'approbation.
APPROVED_HELD La configuration de la facturation a été approuvée, mais le premier budget correspondant ne l'a pas été. Cela ne peut se produire que pour les configurations de facturation configurées pour la facturation mensuelle.
APPROVED La configuration de la facturation a été approuvée.
CANCELLED La configuration de facturation a été annulée par l'utilisateur avant son approbation.

PaymentsAccountInfo

Conteneur d'informations sur le 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.

Ce champ doit être transmis sous la forme d'une chaîne contenant des tirets, par exemple "1234-5678-9012-3456".
paymentsAccountName

string

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

Cela permet à l'utilisateur de spécifier un nom pertinent pour un compte de paiement afin de faciliter le rapprochement des factures mensuelles.

Ce nom figurera sur les factures mensuelles.
paymentsProfileId

string

Immuable. ID à 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 facturation.
secondaryPaymentsProfileId

string

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