BillingSetup

Une 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 des ressources BillingSetup se présentent comme suit:

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

enum (BillingSetupStatus)

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

object (PaymentsAccountInfo)

Immuable. Informations du compte de paiement associées à cette configuration de facturation. Lors de la configuration de la facturation, cette information 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 la 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, cette information permet de s'inscrire avec un compte de paiement existant (en l'absence de paiement des informations d'un compte de paiement). 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, elle doit prendre effet. NOW 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, 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 future est autorisée.
startTimeType

enum (TimeType)

Immuable. Heure de début sous forme de type. Seul NOW est autorisé.
Champ d'union end_time. 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'une configuration 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 la 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 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.

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

string

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

Cela permet à l'utilisateur de spécifier un nom explicite pour un 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 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.