Bu sayfada, Kaynak Odaklı Tasarım ve Kaynak Adları geliştirici kılavuzlarını bildiğinizi varsayıyoruz ve bu kılavuzları Search Ads 360 Reporting API'nin belirli uygulama ayrıntılarıyla tamamlıyoruz.
Kaynak odaklı tasarım
Genel olarak Search Ads 360 Reporting API, tek tek adreslenebilir kaynakların (API'nin adları) koleksiyonları olarak modellenmiş, kaynağa dayalı bir tasarıma sahiptir. 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://searchads360.googleapis.com/v0/customers/1234567890/searchAds360:search
| API Sürümü Ön Eki | Kaynak Adı (göreceli) | Yöntem |
|---|---|---|
https://searchads360.googleapis.com/v0
|
customers/1234567890
|
search
|
API'nin belirli bir sürümü için tüm REST URL'leri (ör. v0)
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.
Search Ads 360 Reporting API, list ve get gibi standart REST yöntemlerini kullanan çoğu geleneksel REST API'nin aksine özel yöntemleri yoğun şekilde kullanır. Search Ads 360 Reporting API, search ve searchStream olmak üzere iki özel yöntem içerir.
Aşağıdaki sayfalarda, Search Ads 360 Reporting API'nin kaynak adları, hizmet yöntemleri ve JSON adlandırma kuralları hakkında daha fazla bilgi verilmektedir. Bu bilgiler, REST arayüzü uç noktalarını tanımlamak için bunların birlikte nasıl kullanıldığını göstermektedir.