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 tamamlanır.
Kaynak odaklı tasarım
Genel olarak Google Ads API, ayrı ayrı adreslenebilir kaynakların (API'nin adları) koleksiyonları olarak modellenen, kaynağa dayalı bir tasarım kullanır. Kaynaklara, kaynak adlarıyla referans verilir ve kaynaklar, küçük bir yöntem (fiil veya işlem olarak da bilinir) grubu kullanılarak değiştirilir. Bu kaynak adları ve yöntemler, belirli bir API sürümü önekiyle birleştirildiğinde REST arayüzünün URL'lerini oluşturur. Örneğin, aşağıdaki örnek URL, aşağıdaki tabloya göre şu bileşenlere ayrılabilir:
https://googleads.googleapis.com/v26/customers/1234567890:mutate
| API Sürümü Öneki | Kaynak Adı (göreli) | Yöntem |
|---|---|---|
https://googleads.googleapis.com/v26
|
customers/1234567890
|
mutate
|
API'nin belirli bir sürümüne (ör. v26) ait tüm REST URL'leri ortak bir API sürümü ön ekini paylaşır. Kaynak adı ve yöntem, 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 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 fazla bilgi verilmektedir.
Hata yönetimi
Oluşan hataları analiz etme ve hatalarda hata ayıklama hakkında bilgi edinmek için API hatalarını anlama başlıklı makaleyi inceleyin.
Keşif belgesi
Google Ads API'deki kullanılabilir yöntemlerin keşfini kolaylaştırmak ve otomatikleştirmek için her sürüm için yayınlanan keşif belgesini kullanabilirsiniz.
https://googleads.googleapis.com/$discovery/rest?version=<API_VERSION> adresinden erişebilirsiniz.
Örneğin, Google Ads API'nin en yeni sürümünün keşif belgesi budur.
Keşif belgesi, Google Ads API'de kullanılan tüm hizmetler, yöntemler, kaynaklar ve varlıklar hakkında bilgi içerir. Referans dokümanları gibi, ancak makine tarafından okunabilir bir JSON biçimindedir.