Änderung

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"
    }
  ]
}