Bu sayfada, Resource Oriented Design ve Resource Names geliştirici kılavuzlarının bilindiği varsayılmakta ve bu kılavuzlar, Google Ads API'nin belirli uygulama ayrıntılarıyla desteklenmektedir.
Kaynak odaklı tasarım
Google Ads API genellikle kaynağa dayalı bir tasarıma sahiptir ve tek tek adreslenebilir kaynakların (API'nin isimleri) koleksiyonları olarak modellenir. Kaynaklara kaynak adlarıyla referans verilir ve küçük bir yöntem (fiil veya işlem olarak da bilinir) grubu kullanılarak işlenir.
Bu kaynak adları ve yöntemler, belirli bir API sürümü öneki ile birlikte REST arayüzünün URL'lerini oluşturur. Örneğin, aşağıdaki URL, aşağıdaki tabloya göre şu ayrı bileşenlere ayrılabilir:
https://googleads.googleapis.com/v21/customers/1234567890:mutate
| API Sürümü Öneki | Kaynak adı (göreli) | Yöntem |
|---|---|---|
https://googleads.googleapis.com/v21
|
customers/1234567890
|
mutate
|
API'nin belirli bir sürümüne ait tüm REST URL'leri (ör. v21)
ortak bir API sürümü öneki paylaşın. Kaynak adı ve yöntem birlikte hangi API hizmetinin çağrıldığını tanımlar.
Google Ads API, list, get, create, update ve delete gibi standart REST yöntemlerini kullanan geleneksel REST API'lerin aksine özel yöntemleri yoğun bir şekilde kullanır. Google Ads API'deki özel yöntemlere örnek olarak search, searchStream ve mutate verilebilir.
Aşağıdaki sayfalarda, REST arayüzü uç noktalarını tanımlamak için birlikte nasıl kullanıldıklarını göstermek amacıyla Google Ads API'nin kaynak adları, hizmet yöntemleri ve JSON adlandırma kuralları hakkında daha ayrıntılı bilgiler verilmektedir.