İster yeni başlıyor olun, ister bir uygulamayı sürdürüyor olun, ister mevcut bir entegrasyona yeni özellikler ekliyor olun, başarılı bir Google Ads API entegrasyonu oluşturmak için test önemli bir adımdır. Bu kılavuzda, Google Ads API entegrasyonunuzu test etmeyle ilgili bazı en iyi uygulamalar sunulmaktadır.
Test hesapları ve üretim hesapları
Geliştirme amacıyla test hesapları kullanılabilir. Test hesaplarıyla uygulama kodunuzun ve yapılandırmanızın beklendiği gibi çalıştığını doğrulayabilirsiniz.
Ancak bazı özellikler test hesabında test edilemez.
Test hesabı sınırlamaları, entegrasyonunuzdaki bazı özellikleri test etmenizi engellediğinde bunun yerine geliştirme için bir üretim hesabı kullanabilirsiniz. Google Cloud projenizin, üretim hesabı çağırmak için en az Explorer erişim düzeyinde (Explorer, Basic veya Standard) olması gerekir. Gezgin erişiminin, faturalandırma (BillingSetupService
ve AccountBudgetProposalService), planlama, hesap oluşturma ve kullanıcı davetleri (Gezgin özelliği kısıtlamaları bölümüne bakın) gibi temel veya standart erişim gerektiren belirli hizmetleri kısıtladığını unutmayın. Test erişim düzeyine sahip bir projeden bir üretim hesabını çağırma girişimi, AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION değerini döndürür. Bu değer, v25 sürümünden itibaren geçerlidir. v24 ve önceki sürümlerde ise AuthorizationError.ACTION_NOT_PERMITTED değeri döndürülür.
Geliştirme için kullanılan üretim hesapları, test hesaplarından şu açılardan farklıdır:
- Kullanıcıların görebileceği reklamlar yayınlayın
- Geçerli URL'ler gerektirir
- Reklamcılık politikalarına uymalıdır.
Üretim hesapları reklam yayınladığı için performans raporlarını test etmenize olanak tanıyan metrikler oluşturur ve Google Ads API'nin diğer tüm özelliklerini kullanmanızı sağlar. Ancak bunları geliştirme için kullanırken ekstra dikkatli olmanız gerekir. Aşağıdaki önlemleri almanızı öneririz:
- Yalnızca geliştirme amacıyla erişime ihtiyaç duyan kullanıcılara erişim izni verin.
- Sabit ve düşük bir günlük hesap bütçesi belirleyin.
- Geliştirme için yalnızca test hesapları kullanılamadığında üretim hesaplarını kullanın.
Bu nedenle, entegrasyonunuzun tam olarak test edilmesi için hem test kimlik bilgilerine hem de üretim kimlik bilgilerine ihtiyacınız olacaktır.
Test amaçlı kimlik bilgileri
Geliştirme hesaplarını değiştirmeye çalışırken üretim hesaplarını yanlışlıkla değiştirme riskini en aza indirmek için üretim uygulaması kimlik bilgilerinizden ayrı bir test kimlik bilgileri grubu kullanmanızı öneririz.
Bir dizi test kimlik bilgisi oluşturmak için aşağıdaki adımları uygulayın:
- Yalnızca test amacıyla kullanılacak bir e-posta hesabı (örneğin,
api.test@example.com) veya hizmet hesabı oluşturun. - Bu kullanıcıyı veya hizmet hesabını, testlerinizi yürüttüğünüz Google Ads hesaplarına geçerli kullanıcı olarak ekleyin. Bu kullanıcıya veya hizmet hesabına uygun erişim düzeyleri verdiğinizden emin olun. Bu kullanıcıya veya hizmet hesabına üretim hesaplarına erişim izni vermeyin.
- Hizmet hesabı akışı yerine OAuth 2.0 kullanıcı kimlik doğrulaması akışını kullanıyorsanız test kullanıcı hesabınız için yenileme jetonu oluşturun.
- Uygulamanızı test ederken bu yeni kimlik bilgilerini kullanın. Müşteri kimliği ve müşteri gizli anahtarı, hangi Google Ads hesaplarına erişilebileceğini belirlemede herhangi bir etkisi olmadığından test amacıyla yeniden kullanılabilir. Tüm kimlik bilgilerini ve yenileme jetonlarını güvenli bir şekilde saklayın ve asla kaynak kontrolüne işlemeyin.
Doğrulama isteğinde bulun
Yalnızca bir isteğin geçerli olup olmadığını test etmeniz gerekiyorsa (ör. isteğin doğru şekilde yapılandırıldığını ve politikaları ihlal etmediğini doğrulamak için) validate_only alanını kullanabilirsiniz. Bu alan, GoogleAdsService.Search istekleri (GoogleAdsService.SearchStream'ın validate_only'ı desteklemediğini unutmayın) ve çoğu değiştirme isteği için kullanılabilir. Bu alanın belirli bir yöntem için kullanılabilir olup olmadığını doğrulamak üzere referans belgelerine bakın.
REST API
Örneğin, bir isteğin beklenen çıktıyı verdiğini doğrulamak için yapılan geçici testlerde genellikle en kolay seçenek REST API'yi kullanmaktır. REST API'ye istekte bulunmak için curl'ü nasıl kullanacağınızı öğrenmek üzere REST örneklerine bakın. Ayrıca, REST Explorer'da test etmeyi deneyin.