Method: customers.billingSetups.mutate

Consente di creare una configurazione di fatturazione o di annullarne una esistente.

Elenco degli errori generati: AuthenticationError AuthorizationError BillingSetupError DateError FieldError HeaderError InternalError MutateError QuotaError RequestError

Richiesta HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/billingSetups:mutate

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. ID del cliente a cui applicare l'operazione di modifica della configurazione di fatturazione.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "operation": {
    object (BillingSetupOperation)
  }
}
Campi
operation

object (BillingSetupOperation)

Obbligatorio. L'operazione da eseguire.

Corpo della risposta

Messaggio di risposta per un'operazione di configurazione della fatturazione.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "result": {
    object (MutateBillingSetupResult)
  }
}
Campi
result

object (MutateBillingSetupResult)

Un risultato che identifica la risorsa interessata dalla richiesta di modifica.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/adwords

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

BillingSetupOperation

Una singola operazione su una configurazione di fatturazione, che descrive l'annullamento di una configurazione di fatturazione esistente.

Rappresentazione JSON
{

  // Union field operation can be only one of the following:
  "create": {
    object (BillingSetup)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Campi
Campo di unione operation. È possibile impostare una sola di queste operazioni. Le operazioni di "aggiornamento" non sono supportate. operation può essere solo uno dei seguenti:
create

object (BillingSetup)

Crea una configurazione di fatturazione. Non è previsto alcun nome della risorsa per la nuova configurazione di fatturazione.

remove

string

Nome risorsa della configurazione di fatturazione da rimuovere. Una configurazione non può essere rimossa a meno che non si trovi in stato di attesa o l'ora di inizio pianificata non sia nel futuro. Il nome della risorsa è simile a customers/{customerId}/billingSetups/{billing_id}.

MutateBillingSetupResult

Risultato per una singola modifica della configurazione di fatturazione.

Rappresentazione JSON
{
  "resourceName": string
}
Campi
resourceName

string

Restituito per operazioni riuscite.