Authentication

ReachPlanService'e yapılan isteklerde onaylanmış bir geliştirici jetonu, OAuth kimlik bilgileri ve OAuth kimlik bilgilerinizin erişebileceği bir müşteri kimliği sağlanmalıdır.

Bu kılavuzda, ReachPlanService'a özgü kimlik doğrulama ayrıntıları ele alınmaktadır. Henüz yapmadıysanız önce Başlarken bölümünde açıklanan adımları tamamlayın, ardından bu noktaya geri dönün.

Geliştirici jetonu ve OAuth kimlik bilgileri

Başlarken bölümünde sunulan rehberliğe ek olarak aşağıdaki noktaları da göz önünde bulundurun:

1. ReachPlanService'ye bağlanmak için geliştirici jetonunuzun uygun izin verilenler listesine eklenmesi gerekir. Bu jetonun diğer Google Ads API hizmetleriyle kullanım için onaylanmış olması bu durumu değiştirmez. Daha fazla bilgi için uygunluk koşullarını inceleyin.
2. Google Ads API'ye bağlanmak için Google Ads API Hizmet Şartları'nı kabul etmeniz gerekir.
3. OAuth yenileme jetonunuzun sahibi olan kullanıcı, ReachPlanService içinde hangi müşteri kimliklerini sorgulayabileceğinizi belirler. Bu, entegrasyonunuzu etkiler ve aşağıdaki bölümlerde daha ayrıntılı olarak açıklanır.

Müşteri Numaraları

Google Ads API'deki çoğu hizmet belirli Google Ads hesaplarında ve kampanyalarında çalışır. Bu nedenle, çoğu istekte yönettiğiniz veya sorguladığınız hesabı tanımlamak için bir müşteri kimliği ve bu müşteri kimliğine erişme izni olan OAuth kimlik bilgileri gerekir. Ancak ReachPlanService bir kampanyayı hangi müşteri kimliğinde yayınlayacağınızı bilmeden önce gerçekleşebilecek video planlama etkinlikleri için tasarlanmıştır.

Dahili araçlar

Kuruluşunuzda dahili kullanım için araçlar geliştiriyorsanız önerilerimizi aşağıda bulabilirsiniz.

Doğrudan müşteri hesabı erişimi olmayan planlayıcılar

Planlayıcılarınızın müşterilerinizin Google Ads hesaplarına erişimi yoksa geliştirici jetonunuzun yönetici hesabına erişimi olan bir kullanıcı için yüklü uygulama akışını kullanarak OAuth kimlik bilgileri oluşturun. Ardından, aracınızı kullanan her ekip için bir Google Ads hesabı oluşturun veya edinin ve bu hesapları yönetici hesabınıza bağlayın. ReachPlanService'ye istek gönderirken kullanıcının ekibine karşılık gelen müşteri kimliğini belirtin.

Müşteri hesabı erişimi olan planlayıcılar

Planlamacılarınız, müşterilerinizin hesaplarını yöneten bir Google Ads yönetici hesabına erişebiliyorsa uygulamanızın planlamacılarınızın OAuth kimlik bilgilerini kullanmasına izin vermek için web uygulaması akışını uygulayın. Ardından, planınızın müşterisine karşılık gelen müşteri kimliğini iletebilirsiniz.

Harici araçlar

Harici kullanıcılar için bir araç oluşturuyorsanız benzer yaklaşımlar kullanmanızı öneririz:

Müşteri hesapları

Geliştirici jetonunuzun yönetici hesabına erişimi olan bir kullanıcı için yüklü uygulama akışını kullanarak OAuth kimlik bilgileri oluşturun. Her harici müşteri için bir Google Ads hesabı oluşturun ve bu hesapları yönetici hesabınıza bağlayın. Ardından, müşteriler plan oluştururken ilgili müşteri kimliğini sağlayacak şekilde aracınızı yapılandırın.

Kullanıcı tarafından verilen erişim

Web uygulaması akışını kullanarak kullanıcılarınıza, araçlarınıza hesaplarına erişim izni verme olanağı tanıyın. Kullanıcı izin verdikten sonra, erişebilecekleri Google Ads hesaplarının listesini sağlamak için CustomerService kullanın.

Amaç, planlayıcıların ReachPlanService kullanırken mümkün olduğunca az sorun yaşamalarını sağlamaktır. API'yi entegre etmeden önce durumunuza göre iki yaklaşımdan birini seçin ve test etmek için birkaç müşteri kimliği belirleyin. Emin değilseniz araç türünüz için önerilen ilk yaklaşımı kullanın.

Sırada ne var?

Medya planı belirtmeyi öğrenin.