- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- CustomAudienceOperation
- MutateCustomAudienceResult
- Prova!
Crea o aggiorna i segmenti di pubblico personalizzati. Vengono restituiti gli stati delle operazioni.
Elenco degli errori generati: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationErrorQuotaErrorRequestError
Richiesta HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/customAudiences:mutate
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
Obbligatorio. L'ID del cliente di cui vengono modificati i segmenti di pubblico personalizzati. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"operations": [
{
object ( |
Campi | |
---|---|
operations[] |
Obbligatorio. L'elenco delle operazioni da eseguire sui singoli segmenti di pubblico 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 del segmento di pubblico 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.
CustomAudienceOperation
Una singola operazione (creazione, aggiornamento) su un segmento di pubblico 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 risorsa per il nuovo segmento di pubblico personalizzato. |
update |
Operazione di aggiornamento: il segmento di pubblico personalizzato deve avere un nome risorsa valido. |
remove |
Operazione di rimozione: è previsto un nome risorsa per il segmento di pubblico personalizzato rimosso, nel seguente formato:
|
MutateCustomAudienceResult
Il risultato del segmento di pubblico personalizzato cambia.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Restituito per operazioni riuscite. |