En İyi Uygulamalar

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 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.