REST Arayüz Tasarımı

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.