- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- AccountLinkOperation
- MutateAccountLinkResult
- Prova!
Crea o rimuove un collegamento degli account. Dalla versione V5, la creazione non è supportata tramite AccountLinkService.MutateAccountLink. Utilizza invece AccountLinkService.CreateAccountLink.
Elenco degli errori generati: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError
Richiesta HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/accountLinks:mutate
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
Obbligatorio. L'ID del cliente in fase di modifica. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"operation": {
object ( |
Campi | |
---|---|
operation |
Obbligatorio. L'operazione da eseguire sul collegamento. |
partialFailure |
Se il valore è true, le operazioni riuscite verranno eseguite e quelle non valide restituiranno errori. Se impostato su false, tutte le operazioni verranno eseguite in un'unica transazione solo se sono tutte valide. Il valore predefinito è false. |
validateOnly |
Se il valore è true, la richiesta viene convalidata ma non eseguita. Vengono restituiti solo gli errori, non i risultati. |
Corpo della risposta
Messaggio di risposta per la modifica del collegamento dell'account.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "result": { object ( |
Campi | |
---|---|
result |
Risultato della mutazione. |
partialFailureError |
Errori relativi a errori delle operazioni in modalità di errore parziale. Errore restituito solo quando partialFailure = true e tutti gli errori si verificano all'interno delle operazioni. Se si verificano errori al di fuori delle operazioni, ad esempio errori di autenticazione, verrà restituito un errore a livello di RPC. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/adwords
Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
AccountLinkOperation
Un singolo aggiornamento al collegamento di un account.
Rappresentazione JSON |
---|
{ "updateMask": string, // Union field |
Campi | |
---|---|
updateMask |
Maschera di campo che determina quali campi delle risorse vengono modificati in un aggiornamento. Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: |
Campo di unione operation . L'operazione da eseguire. operation può essere solo uno dei seguenti: |
|
update |
Operazione di aggiornamento: il link dell'account deve avere un nome risorsa valido. |
remove |
Operazione di rimozione: è previsto un nome risorsa da rimuovere dal collegamento dell'account, nel seguente formato:
|
MutateAccountLinkResult
Cambiamento del risultato del collegamento dell'account.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Restituito per operazioni riuscite. |