Achtung:Sie lesen die Dokumentation für die REST-Schnittstelle der API. Die meisten unserer offiziellen Clientbibliotheken verwenden gRPC.
Weitere Informationen
Dienstmethoden
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Das Design der Google Ads API unterscheidet sich von einer herkömmlichen REST-Architektur, da hauptsächlich benutzerdefinierte Methoden wie search und mutate, anstelle der herkömmlichen Methoden list, get, create, update und delete verwendet werden.
Diese Aktionen werden in REST-URLs mit der HTTP-Zuordnung-Konvention eines : ausgedrückt, um das benutzerdefinierte Verb vom Rest der URL zu trennen.
Für einen API-Aufruf zum Ändern einer Kampagne wird beispielsweise die folgende URL verwendet:
https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate
Ein Grund dafür, dass in der API benutzerdefinierte Methoden verwendet werden, ist, dass mehrere Vorgänge in einer einzigen API-Anfrage zusammengefasst werden können. Gemäß der REST-Semantik wäre es nur möglich, jeweils eine Kampagne zu aktualisieren. Für eine herkömmliche REST-update für eine Kampagne wäre beispielsweise eine HTTP-PATCH-Anfrage pro Kampagnenressource erforderlich.
Damit viele Vorgänge in einem einzelnen Anfragebody zusammengefasst werden können, wird in der Google Ads API für die meisten Ressourcen stattdessen eine benutzerdefinierte mutate-Methode definiert.
Um Batchlesevorgänge (Abrufen vieler Objekte gleichzeitig) über die API zu ermöglichen, wird in der API eine benutzerdefinierte search-Methode mit einer SQL-ähnlichen Google Ads-Abfragesprache verwendet.
Auf der Seite Gängige Methoden werden die am häufigsten verwendeten Methoden in der Google Ads API ausführlich beschrieben.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-27 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-27 (UTC)."],[[["\u003cp\u003eThe Google Ads API utilizes custom methods like \u003ccode\u003esearch\u003c/code\u003e and \u003ccode\u003emutate\u003c/code\u003e instead of standard REST methods for efficiency and batch operations.\u003c/p\u003e\n"],["\u003cp\u003eThis approach allows for updating multiple campaigns or fetching numerous objects within a single request, unlike traditional REST.\u003c/p\u003e\n"],["\u003cp\u003eCustom methods are expressed in REST URLs using a colon to separate the verb from the rest of the URL, for example, \u003ccode\u003ehttps://googleads.googleapis.com/v18/customers/1234567890/campaigns:mutate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eBatching operations, like updating many campaigns simultaneously, are enabled through the custom \u003ccode\u003emutate\u003c/code\u003e method, improving efficiency over individual requests.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esearch\u003c/code\u003e method uses a SQL-like query language for batch reads, enabling retrieval of multiple objects in one API call.\u003c/p\u003e\n"]]],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"],null,["# Service Methods\n\nThe design of the Google Ads API differs from a traditional REST architecture\nbecause it primarily uses custom methods, such as `search` and `mutate,` instead\nof the more traditional `list`, `get`, `create`, `update`, and `delete` methods.\nThese actions are expressed in REST URLs by using the [HTTP mapping](https://cloud.google.com/apis/design/custom_methods#http_mapping)\nconvention of a `:` to separate the custom verb from the rest of the URL.\n\nFor example, a campaign mutate API call uses the following URL: \n\n https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate\n\nOne reason that the API uses custom methods is to enable batching of multiple\noperations into a single API request. Strict REST semantics would only allow\nupdating one campaign at a time. A traditional REST\n[`update`](https://cloud.google.com/apis/design/standard_methods#update) to a\ncampaign, for example, would require sending one HTTP PATCH request per campaign\nresource.\n\nTo allow many operations to be bundled together within a single request body,\nthe Google Ads API instead defines a custom `mutate` method for most resources.\nSimilarly, to enable batch reads (fetching many objects at once) from the API,\nthe API uses a custom `search` method with a SQL-like [Google Ads Query\nLanguage](/google-ads/api/docs/query/overview).\n\nThe [Common methods](/google-ads/api/rest/common/overview) page goes into detail on\nthe most frequently used methods in the Google Ads API."]]
