Bu sayfada, Kaynak Odaklı Kaynaklar hakkında bilgi sahibi olduğunuz Tasarım ve Kaynak Adlar geliştirici kılavuzları ve bunları Google Ads API'nin belirli uygulama ayrıntılarıyla tamamlar.
Kaynak odaklı tasarım
Google Ads API genel olarak kaynak odaklı bir tasarıma sahiptir ve ayrı ayrı ele alınabilen kaynakların koleksiyonları (API'nin isimleri). Kaynaklar, kaynak adlarıyla belirtilir ve küçük bir yöntemler grubu (fiiller veya işlemler olarak da bilinir).
Bu kaynak adları ve yöntemler birlikte özel bir API sürümü öneki ile başlayanlar, REST arayüzünün URL'lerini oluşturur. Örneğin, aşağıdaki URL bu bağımsız bileşenlere ayrılabilir. aşağıdaki tabloya göre:
https://googleads.googleapis.com/v17/customers/1234567890:mutate
API Sürümü Öneki | Kaynak Adı (göreli) | Yöntem |
---|---|---|
https://googleads.googleapis.com/v17
|
customers/1234567890
|
mutate
|
API'nin belirli bir sürümüne (ör. v17
) olarak değiştirildi
ortak bir API sürümü ön eki paylaşın. Kaynak adı ve yöntemi birlikte
hangi API hizmetinin çağrıldığını tanımlar.
Google Ads API, çoğu platformun aksine özel yöntemleri yoğun bir şekilde
list
, get
gibi standart REST yöntemlerini kullanan geleneksel REST API'leri
create
, update
ve delete
. Google Ads API'deki özel yöntem örnekleri
search
, searchStream
ve mutate
dahil.
Aşağıdaki sayfalarda, Google Ads API'nın kaynağı hakkında daha ayrıntılı bilgi verilmektedir. adları, hizmet yöntemleri ve Nasıl kullanıldıklarını gösteren JSON adlandırma kuralları kullanarak REST arayüzü uç noktalarını tanımlayabilirsiniz.