Bu sayfada, Kaynak Odaklı Tasarım ve Kaynak Adları geliştirici kılavuzları hakkında bilgi sahibi olduğunuz varsayılır ve bu kılavuzlar Google Ads API'nin belirli uygulama ayrıntılarıyla desteklenir.
Kaynak odaklı tasarım
Genel olarak Google Ads API, bağımsız olarak ele alınabilen kaynakların (API'nin isimleri) koleksiyonları olarak modellenmiş kaynak odaklı bir tasarıma sahiptir. Kaynaklar, kaynak adlarıyla belirtilir ve küçük bir yöntem (fiiller veya işlemler olarak da bilinir) kullanılarak değiştirilir.
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 bu bileşenlere ayrılabilir:
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)
yaygın bir API sürümü öneki paylaşır. Kaynak adı ve yöntemi 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'lerinin çoğunun 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 bunların birlikte nasıl kullanıldığı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ı bilgi verilmektedir.