Die meisten Ressourcen werden mit einem Mutate geändert (erstellt, aktualisiert oder entfernt)
. Die Methode Mutate wird als HTTP-POST für eine ressourcenspezifische
URL, die mit dem Muster für den Ressourcennamen übereinstimmt, ohne nachgestellte Ressourcen-ID.
Die IDs der zu ändernden Ressourcen werden stattdessen in der JSON-Anfrage gesendet.
Textkörper. So können Sie einen einzelnen API-Aufruf mit mehreren Vorgängen
unterschiedlichen Ressourcen.
Der Ressourcenname einer Kampagne hat beispielsweise folgendes Format:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
Um die URL für mutierende Kampagnen abzuleiten, lassen Sie die nachgestellte Ressourcen-ID weg und
Fügen Sie :mutate hinzu:
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/campaigns:mutate
Eine Mutate-Nachricht enthält ein JSON-Objekt der obersten Ebene mit einem operations-Array.
die viele operation-Objekte enthalten kann. Jeder Vorgang kann wiederum
create, update oder remove. Dies sind die einzig möglichen mutate-Vorgänge
Geschäftsabläufe.
POST /v17/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"operations": [
...
]
}
Die meisten Dienste unterstützen Tausende von Vorgängen in einem einzigen API-Aufruf. Das System Im Leitfaden zu den Grenzwerten die Beschränkungen für Anfragegrößen.
Vorgänge innerhalb einer einzelnen API-Anfrage werden als eine Reihe von Aktionen von
d. h. entweder alle gemeinsam
oder der gesamte Batch scheitert, wenn
ein einzelner Vorgang fehlschlägt. Einige Dienste unterstützen eine
Attribut partialFailure
um dieses Verhalten zu ändern. Weitere Informationen finden Sie unter Ressourcen stummschalten.
finden Sie weitere Informationen zur Semantik von mutate-Vorgängen.
Erstellen
Erstellungsvorgänge erzeugen neue Entitäten und müssen eine vollständige JSON-Datei enthalten Darstellung der Ressource, die Sie erstellen möchten.
POST /v17/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"operations": [
{
"create": {
"name": "An example campaign",
"status": "PAUSED",
"campaignBudget": "customers/CUSTOMER_ID/campaignBudgets/CAMPAIGN_BUDGET_ID",
"advertisingChannelType": "SEARCH",
"networkSettings": {
"targetGoogleSearch": true,
"targetSearchNetwork": true,
"targetContentNetwork": true,
"targetPartnerSearchNetwork": false
},
"target_spend": {}
}
}
]
}
Aktualisieren
Aktualisierungsvorgänge führen dünnbesetzte Aktualisierungen für eine vorhandene Ressource aus. Sie benötigen nur um die Felder anzugeben, die Sie ändern möchten.
Um die Felder anzugeben, die Sie aktualisieren möchten, setzen Sie das Attribut updateMask auf
eine durch Kommas getrennte Liste von Feldnamen. Dies ist besonders nützlich, wenn Sie
bereits über eine vollständig formatierte JSON-Darstellung eines Objekts verfügen (z. B. als
zurückgegeben, aber nur bestimmte Felder ändern möchten.
Anstatt das JSON-Objekt zu kürzen, können Sie einfach die Feldnamen auflisten,
in updateMask geändert und das gesamte JSON-Objekt gesendet.
Im folgenden Beispiel werden name und status einer vorhandenen Kampagne mit
die angegebene resourceName.
POST /v17/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"operations": [
{
"updateMask": "name,status",
"update": {
"resourceName": "customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID",
"name": "My renamed campaign",
"status": "PAUSED",
}
}
]
}
Entfernen
Durch Entfernen von Vorgängen wird ein Objekt effektiv gelöscht, wobei sein Google Ads-Status auf festgelegt wird.
REMOVED Nur das zu entfernende resourceName ist erforderlich.
POST /v17/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"operations": [
{
"remove": "customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID"
}
]
}