- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- CustomAudienceOperation
- MutateCustomAudienceResult
- Testen!
Benutzerdefinierte Zielgruppen erstellen oder aktualisieren Vorgangsstatus werden zurückgegeben.
Liste der geworfenen Fehler: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationError{225PolicyError HeaderErrorRequestError
HTTP-Anfrage
POST https://googleads.googleapis.com/v14/customers/{customerId}/customAudiences:mutate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
customerId |
Erforderlich. Die ID des Kunden, dessen benutzerdefinierte Zielgruppen geändert werden. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"operations": [
{
object ( |
Felder | |
---|---|
operations[] |
Erforderlich. Die Liste der Vorgänge, die für einzelne benutzerdefinierte Zielgruppen ausgeführt werden sollen. |
validateOnly |
Falls wahr, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse. |
Antworttext
Antwortnachricht für benutzerdefinierte Zielgruppe mutate.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"results": [
{
object ( |
Felder | |
---|---|
results[] |
Alle Ergebnisse für die mutate. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/adwords
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
CustomAudienceOperation
Ein einzelner Vorgang (Erstellen, Aktualisieren) für eine benutzerdefinierte Zielgruppe.
JSON-Darstellung |
---|
{ "updateMask": string, // Union field |
Felder | |
---|---|
updateMask |
FieldMask, die bestimmt, welche Ressourcenfelder bei einer Aktualisierung geändert werden. Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: |
Union-Feld operation . Der mutate-Vorgang. Für operation ist nur einer der folgenden Werte zulässig: |
|
create |
Erstellungsvorgang: Für die neue benutzerdefinierte Zielgruppe wird kein Ressourcenname erwartet. |
update |
Aktualisierungsvorgang: Die benutzerdefinierte Zielgruppe muss einen gültigen Ressourcennamen haben. |
remove |
Entfernen: Es wird ein Ressourcenname für die entfernte benutzerdefinierte Zielgruppe im folgenden Format erwartet:
|
MutateCustomAudienceResult
Das Ergebnis der „mutate“-Methode der benutzerdefinierten Zielgruppe.
JSON-Darstellung |
---|
{ "resourceName": string } |
Felder | |
---|---|
resourceName |
Wird für erfolgreiche Vorgänge zurückgegeben. |