- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- CustomInterestOperation
- MutateCustomInterestResult
- Prova!
Crea o aggiorna interessi personalizzati. Vengono restituiti gli stati delle operazioni.
Elenco degli errori generati: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError
Richiesta HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/customInterests:mutate
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
Obbligatorio. L'ID del cliente i cui interessi personalizzati vengono modificati. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"operations": [
{
object ( |
Campi | |
---|---|
operations[] |
Obbligatorio. L'elenco di operazioni da eseguire sui singoli interessi personalizzati. |
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 modifica dell'interesse personalizzato.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"results": [
{
object ( |
Campi | |
---|---|
results[] |
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.
CustomInterestOperation
Una singola operazione (creazione, aggiornamento) su un interesse personalizzato.
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 di modifica. operation può essere solo uno dei seguenti: |
|
create |
Operazione di creazione: non è previsto alcun nome della risorsa per il nuovo interesse personalizzato. |
update |
Operazione di aggiornamento: l'interesse personalizzato deve avere un nome risorsa valido. |
MutateCustomInterestResult
Il risultato della modifica dell'interesse personalizzato.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Restituito per operazioni riuscite. |