Objekte ändern

Wie im Leitfaden zur API-Struktur beschrieben, hat jede Ressource der obersten Ebene in der Google Ads API einen entsprechenden ressourcentypspezifischen Dienst, der das Ändern von Instanzen der Ressource unterstützt.

In diesem Leitfaden wird CampaignService verwendet, um das Ändern von Campaign-Objekten zu veranschaulichen. Die gleichen Konzepte gelten jedoch für alle anderen ressourcentypspezifischen Dienste.

Objekte ändern

Jeder ressourcentypspezifische Dienst hat eine mutate-Methode, die eine Änderungsanfrage akzeptiert. Diese Anfrage besteht aus:

• Einer customerId
• Einer Sammlung von Vorgängen
• Einer Einstellung für den Antwortinhaltstyp, die bestimmt, ob die änderbare Ressource oder nur der Ressourcenname nach der Mutation zurückgegeben werden soll.

Die Methode MutateCampaigns von CampaignService akzeptiert beispielsweise eine MutateCampaignsRequest, die aus Folgendem besteht:

• Einer customerId
• Einer Sammlung von CampaignOperation-Objekten
• Das Feld response_content_type, das den bevorzugten Antworttyp angibt.

Vorgänge

Mit einem Vorgangsobjekt wie CampaignOperation können Sie die Aktion angeben, die Sie für eine einzelne Ressource ausführen möchten, indem Sie das Feld operation festlegen. Dieses Feld ist ein Oneof-Feld das aus den folgenden Attributen besteht, deren Typ der Ressourcentyp ist:

create

Erstellt eine neue Instanz der Ressource.

update

Aktualisiert die Ressource, sodass sie den Attributen von update

entspricht. Wenn dieses Feld festgelegt ist, müssen Sie auch die update_mask des Vorgangs festlegen. Dadurch wird der Google Ads API mitgeteilt, welche Attribute während des Aktualisierungsvorgangs geändert werden sollen. Jede Clientbibliothek enthält eine Utility oder Hilfsmethode, mit der die update_mask für Sie generiert wird, wie in unseren Clientbibliotheken gezeigt.

remove

Entfernt die Ressource.

Da das Feld operation ein oneof-Feld ist, können Sie mit einem einzelnen Vorgang nicht mehrere Objekte ändern. Wenn Sie beispielsweise eine Kampagne erstellen und eine andere entfernen möchten, fügen Sie Ihrer Anfrage zwei Instanzen von CampaignOperation hinzu: eine mit create und eine mit remove.

Batchvorgänge

Ein einzelner Vorgang kann nur eine einzelne Ressource erstellen, aktualisieren oder entfernen. Eine einzelne Änderungsanfrage kann jedoch mehrere Vorgänge enthalten. Sie sollten Ihre Vorgänge in einer einzigen Änderungsanfrage kombinieren, anstatt mehrere Änderungsanfragen zu senden, die jeweils einen einzelnen Vorgang enthalten.

Wenn Sie beispielsweise zehn Kampagnen erstellen möchten, sollten Sie eine einzige MutateCampaignsRequest mit zehn CampaignOperation-Objekten senden.

Antworten auf Änderungen

Was in der Antwort zurückgegeben wird, hängt davon ab, was in der response_content_type der Änderungsanfrage gesendet wurde. Wenn beispielsweise MUTABLE_RESOURCE angegeben wurde, enthält die Antwort nur die änderbaren Felder in der Kampagne. Sie können dann weitere Änderungen an diesem Ressourcenobjekt vornehmen, ohne es neu erstellen zu müssen.

Fehler bei Änderungen

Die Vorgänge in einer bestimmten Änderungsanfrage werden nur auf Ihr Google Ads-Konto angewendet, wenn jeder Vorgang in der Anfrage erfolgreich ist. Im Leitfaden zu häufigen Fehlern finden Sie eine Liste häufiger Fehler und Informationen zur Fehlerbehebung.

Änderungen nachverfolgen

Wenn Sie Änderungen an Objekten in Ihrem Google Ads-Konto nachverfolgen oder den aktuellen Status von Objekten abrufen möchten, können Sie die Ressourcen change_status und change_event verwenden.

• change_status enthält eine Zusammenfassung der Ressourcen, die sich innerhalb eines bestimmten Zeitraums geändert haben.
• change_event enthält einen detaillierten Verlauf der Änderungen, einschließlich der alten und neuen Werte der geänderten Felder.

Verwenden Sie die GoogleAdsService.SearchStream oder GoogleAdsService.Search Methode, um diese Ressourcen abzufragen. Weitere Informationen zum Streamen von Berichten mit GoogleAdsService