Bu sayfada, Kaynak Odaklı Tasarım ve Kaynak Adları geliştirici kılavuzlarına aşina olduğunuz varsayılarak bu kılavuzlar, Google Ads API'nin belirli uygulama ayrıntılarıyla tamamlanmaktadır.
Kaynak odaklı tasarım
Genel olarak Google Ads API, kaynak odaklı bir tasarıma sahiptir ve ayrı ayrı ele alınabilen kaynaklardan (API'nın isimleri) oluşan koleksiyonlar olarak modellenir. Kaynaklar, kaynak adlarıyla belirtilir ve küçük bir yöntem grubu (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 ayrı bileşenlere ayrılabilir:
https://googleads.googleapis.com/v16/customers/1234567890:mutate
API Sürümü Öneki | Kaynak Adı (göreli) | Yöntem |
---|---|---|
https://googleads.googleapis.com/v16
|
customers/1234567890
|
mutate
|
API'nin belirli bir sürümüne ait tüm REST URL'leri (ör. v16
)
ortak bir API sürümü öneki paylaşın. 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 çoğu geleneksel REST API'nin 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 verilmiştir.