Test, ister yeni başlıyor ister bir uygulamayı sürdürüyor veya mevcut bir entegrasyona yeni özellikler ekliyor olun, başarılı bir Google Ads API entegrasyonu oluşturmanın önemli bir adımıdır. Bu kılavuzda, Google Ads API entegrasyonunuzu test etmeyle ilgili en iyi uygulamalardan bazıları sunulmaktadır.
Test hesapları ve üretim hesapları
Geliştirme amacıyla test hesapları kullanılabilir. Test hesapları sayesinde uygulama kodunuzun ve yapılandırmanızın amaçlandığı gibi çalıştığını doğrulayabilirsiniz.
Ancak test hesabında tüm özellikler test edilemez.
Test hesabı sınırlamaları, entegrasyonunuzdaki bazı özellikleri test etmenizi engellediğinde geliştirme için üretim hesabı kullanabilirsiniz. Google Cloud projenizin, üretim hesabını çağırabilmesi için en az Gezgin erişim düzeyine (Gezgin, Temel veya Standart) sahip 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 üretim hesabını çağırmaya çalışmak, v25 tarihinden itibaren AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION veya v24 ve daha önceki tarihlerde AuthorizationError.ACTION_NOT_PERMITTED hatasını döndürür.
Geliştirme için kullanılan üretim hesapları, test hesaplarından şu açılardan farklıdır:
- Kullanıcılar tarafından görülebilen reklamlar yayınlama
- Geçerli URL'ler gerektirme
- Reklamcılık politikalarına uymalıdır.
Üretim hesapları reklam yayınladığından, 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 daha dikkatli olmak 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.
- Üretim hesaplarını yalnızca test hesapları kullanılamadığında geliştirme için 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 oluşturmanızı öneririz.
Test kimlik bilgileri oluşturmak için aşağıdaki adımları uygulayın:
- Yalnızca test amacıyla kullanılacak bir e-posta hesabı (ör.
api.test@example.com) veya hizmet hesabı oluşturun. - Bu kullanıcıyı veya hizmet hesabını, testlerinizi çalıştırdığınız Google Ads hesaplarına geçerli bir 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 hiçbir üretim hesabı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 bir yenileme jetonu oluşturun.
- Uygulamanızı test ederken bu yeni kimlik bilgilerini kullanın. İstemci kimliği ve istemci gizli anahtarı, hangi Google Ads hesaplarına erişilebileceğini belirlemede etkili olmadığından test amacıyla yeniden kullanılabilir. Tüm kimlik bilgilerini ve yenileme jetonlarını güvenli bir şekilde saklayın ve bunları hiçbir zaman kaynak denetimine kaydetmeyin.
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şiklik 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
Özel testler için (ör. bir isteğin beklenen çıkışı verdiğini doğrulamak için) REST API'yi kullanmak genellikle en kolay seçenektir. REST API'ye istek göndermek için curl'ü nasıl kullanacağınızı öğrenmek üzere REST örneklerini inceleyin. Ayrıca REST Explorer'da test etmeyi deneyin.