REST Arayüz Tasarımı

Bu sayfada, Kaynak Odaklı Tasarım ve Kaynak Adları geliştirici kılavuzlarını bildiğinizi varsayıyoruz ve bu kılavuzları Google Ads API'nin belirli uygulama ayrıntılarıyla tamamlıyoruz.

Kaynak odaklı tasarım

Genel olarak Google Ads API, tek tek adreslenebilir kaynakların (API'nin adları) koleksiyonları olarak modellenmiş, kaynağa dayalı bir tasarım kullanır. Kaynaklara kaynak adlarıyla referans verilir ve küçük bir yöntem grubu (fiil veya işlem olarak da bilinir) kullanılarak kaynaklar üzerinde işlem yapılır.

Bu kaynak adları ve yöntemler, belirli bir API sürümü ön ekiyle birlikte REST arayüzünün URL'lerini oluşturur. Örneğin, aşağıdaki URL aşağıdaki tabloya göre aşağıdaki bileşenlere ayrılabilir:

https://googleads.googleapis.com/v18/customers/1234567890:mutate
API Sürümü Ön Eki Kaynak Adı (göreceli) Yöntem
https://googleads.googleapis.com/v18 customers/1234567890 mutate

API'nin belirli bir sürümü için tüm REST URL'leri (ör. v18) ortak bir API sürümü ön ekiyle paylaşır. 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 çoğu geleneksel REST API'nin aksine özel yöntemleri yoğun şekilde kullanır. Google Ads API'deki özel yöntemlere örnek olarak search, searchStream ve mutate verilebilir.

Aşağıdaki sayfalarda, Google Ads API'nin kaynak adları, hizmet yöntemleri ve JSON adlandırma kuralları hakkında daha ayrıntılı bilgi verilmektedir. Bu bilgiler, REST arayüzü uç noktalarını tanımlamak için bunların birlikte nasıl kullanıldığını göstermektedir.