Method: customers.ads.mutate

Aggiorna gli annunci. Vengono restituiti gli stati delle operazioni. L'aggiornamento degli annunci non è supportato per TextAd, ExpandedDynamicSearchAd, GmailAd e ImageAd.

Elenco di errori generati: AdCustomizerErrorAdErrorAdSharingErrorAdxErrorAssetErrorAuthenticationErrorAuthorizationErrorFeedAttributeReferenceErrorFieldErrorFieldMaskErrorFunctionErrorFunctionParsingErrorHeaderErrorIdErrorImageErrorInternalErrorListOperationErrorMediaBundleErrorMediaFileErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperatorErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError

Richiesta HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/ads:mutate

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. L'ID del cliente i cui annunci vengono modificati.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "operations": [
    {
      object (AdOperation)
    }
  ],
  "partialFailure": boolean,
  "responseContentType": enum (ResponseContentType),
  "validateOnly": boolean
}
Campi
operations[]

object (AdOperation)

Obbligatorio. L'elenco delle operazioni da eseguire sui singoli annunci.
partialFailure

boolean

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.
responseContentType

enum (ResponseContentType)

L'impostazione del tipo di contenuti della risposta. Determina se la risorsa modificabile o solo il nome della risorsa deve essere restituito dopo la mutazione.
validateOnly

boolean

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 mutazione di un annuncio.

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

Rappresentazione JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateAdResult)
    }
  ]
}
Campi
partialFailureError

object (Status)

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.
results[]

object (MutateAdResult)

Tutti i risultati per la mutazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.