Bu sayfada, Google Ad Manager API'sına uygun uygulama geliştirirken göz önünde bulundurulması gereken çeşitli en iyi uygulamalar ele alınmaktadır.
- Yürütme sırasında hizmet istemcilerini/saplamaları yeniden kullanma
- Nesneleri getirirken sayfalandırmayı kullan
- Toplu güncelleme istekleri
- Uygun olduğunda Ad Manager API istemci nesnesini depola
- PQL'de bağlama parametrelerini kullanma
- Kullanıcı ayrıcalıklarını tutumlu bir şekilde verin
Yürütme işlemi sırasında hizmet istemcilerini/saplamaları yeniden kullanma
Yeni bir hizmet istemcisi/saplama oluşturma, WSDL'nin getirilmesi ve kaynakların tahsis edilmesiyle ilişkili marjinal bir maliyete sahiptir. Mümkünse hizmet istemcisini/saplamayı yürütmenin başında bir kez oluşturun ve gerektiğinde sınıfların ve işlevlerin kullanımına sunun.
Nesneleri getirirken sayfalandırmayı kullan
Tüm hizmetler, sonuçların PQL söz dizimi kullanılarak filtrelenmesine olanak tanıyan bir get*ByStatement()
yöntemini destekler. LIMIT
ve OFFSET
yan tümceleri, büyük sonuç kümelerini sayfalara bölerek zaman aşımlarını önlemek ve yanıt sayfası boyutlarını makul tutmak için kullanılabilir. Nesnelerinizin karmaşıklığına bağlı olarak önerilen sayfa boyutu 200-500'dür.
Toplu güncelleme istekleri
Aynı türde birden fazla nesneyi değiştirirken tüm nesneleri aynı update*()
isteğiyle göndererek daha iyi performans elde edebilirsiniz. Her istek için istemcide ve sunucuda belirli bir ek yük söz konusudur ve toplu işlem, istek sayısını azaltmanın etkili bir yolu olabilir. Örneğin, her çağrıda tek bir sipariş yerine Siparişler grubunu güncellemek için updateOrders
kullanın.
PQL'de bağlama parametrelerini kullanma
Bağlama parametreleri, değişkenleri PQL sorgu ifadesine yerleştirmenin bir yoludur. PQL, iki nokta üst üste ile başlayan, boşluk içermeyen bir ada sahip bağlama değişkenini ifade eder. :name
. PQL söz dizimi sayfasında bir kod örneği sağlanır.
Bağlama değişkenlerini, dizeleri ve değişkenleri sorgu ifadesinde birleştirme ihtiyacını ortadan kaldırarak kod okunabilirliğini iyileştirdikleri için kullanmanızı öneririz. Ayrıca, bağlama parametre değerleri değiştirilerek yeni sorgular yapılabildiği için PQL ifadelerinin yeniden kullanılmasını da kolaylaştırırlar.
Kullanıcı ayrıcalıklarını tutumlu bir şekilde verme
Kullanıcı rolleri oluşturmak/güncellemek için UserService hizmetini kullanırken kullanıcılara ihtiyaç duymadıkları ayrıcalıkları vermemeye dikkat edin. API'nin birçok özelliğine, kullanıcıya yönetici rolü atamak yerine rollerin bir kombinasyonuyla erişilebilir. Bir kullanıcıya hangi rolleri atayacağınıza karar verirken lütfen izinler belgelerine bakın. Ayrıca üçüncü taraf uygulama geliştiricisi olarak bir ağdan sizin için kullanıcı oluşturmasını isterken uygulamanızın hangi erişim düzeyine ihtiyacı olduğunu belirlediğinizden emin olun. Yöneticiden daha az ayrıcalığa sahip bir rol yeterli olabilir.
Kota sınırlarını aşmayın
Ad Manager API'si, dayanıklılık için çeşitli kota sınırları uygular. Uygulamalarınızı bu sınırların altında tutmanız ve API'nin döndürebileceği kota hatalarından herhangi birine nasıl yanıt vereceğinizi bilmeniz önemlidir.
API kotası
API isteklerine uygulanan ilk kota, ağ düzeyinde bir kotadır. Ad Manager 360 hesaplarında sınır saniyede 8, Ad Manager hesapları için saniyede 2 istektir. Bu sınırın aşılması
QuotaError.EXCEEDED_QUOTA
hatasıyla sonuçlanır. Sizin veya şirketinizdeki bir kişinin ağınıza API erişim izni verdiği üçüncü taraf uygulamaları da dahil olmak üzere ağınızda yapılan tüm API istekleri bu kota için geçerlidir.
Sisteme özel kotalar
API kotası, Ad Manager'da yoğun kaynak kullanan belirli sistemleri korumak için tek başına yeterli değildir. Raporlama ve tahmin sistemleri, API hatalarına neden olabilecek kendi kotalarını tanımlar: sırasıyla
QuotaError.REPORT_JOB_LIMIT
ve
ForecastError.EXCEEDED_QUOTA
.
Kota hatalarını işleme
Uygulamanız yukarıdaki kota hatalarından herhangi biriyle karşılaşırsa API isteğini yeniden deneme stratejisi uygulayın. Öncelikle en az 5 saniye beklemenizi öneririz. Hatayı almaya devam ederseniz yeniden denemeler arasındaki süreyi artırmak için üstel geri yükleme özelliğini kullanın. Yeniden deneme başarılı olmazsa ağınızdaki kullanıcılar arasında kotanızı boşaltıp bitirmediğini görmek için API uygulamalarınızı denetleyin.