Dikkat: API'nin REST arayüzüyle ilgili dokümanları görüntülüyorsunuz. Resmi istemci kitaplıklarımızın çoğu gTB kullanır. Ayrıntılar için
REST Tanıtımı'nı inceleyin.
Hizmet Yöntemleri
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Google Ads API'nin tasarımı, geleneksel bir REST mimarisinden farklıdır. Bunun nedeni, daha geleneksel olan list, get, create, update ve delete yöntemleri yerine öncelikle search ve mutate, gibi özel yöntemleri kullanmasıdır.
Bu işlemler, özel fiili URL'nin geri kalanından ayırmak için : HTTP eşleme kuralı kullanılarak REST URL'lerinde ifade edilir.
Örneğin, bir kampanya değiştirme API çağrısında aşağıdaki URL kullanılır:
https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate
API'nin özel yöntemler kullanmasının bir nedeni, birden fazla işlemin tek bir API isteğinde toplu olarak gönderilmesini sağlamaktır. Katı REST semantiği, aynı anda yalnızca bir kampanyanın güncellenmesine izin verirdi. Örneğin, bir kampanyaya yönelik geleneksel bir REST
update işlemi için kampanya kaynağı başına bir HTTP PATCH isteği gönderilmesi gerekir.
Google Ads API, birçok işlemin tek bir istek gövdesinde birlikte paketlenmesine izin vermek için çoğu kaynak için özel bir mutate yöntemi tanımlar.
Benzer şekilde, API'den toplu okuma (aynı anda birçok nesne getirme) işlemini etkinleştirmek için API, SQL benzeri bir Google Ads sorgu dili ile özel bir search yöntemi kullanır.
Sık kullanılan yöntemler sayfasında, Google Ads API'de en sık kullanılan yöntemler ayrıntılı olarak açıklanmaktadır.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-27 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
