Bu belgede, Ad Manager API'si için kimlik doğrulaması yapma hakkında bilgi verilmektedir. Nasıl? kimlik doğrulama işlemi, kullandığınız arayüze ve verilerinizin depolandığı ortama bağlıdır. tüm API isteklerinde Ad Manager API kapsamı.
Ad Manager istemci kitaplıkları Uygulama Varsayılan Kimlik Bilgilerini kullanır kullanarak Ad Manager API kapsamıyla erişim jetonları oluşturun. Bu kılavuzda şunlar gösterilir: Uygulama Varsayılan Kimlik Bilgilerini nasıl yapılandıracağınızı anlatacağım.
İstemci kitaplığı kullanmıyorsanız da kimlik bilgileri oluşturmanız gerekir ve isteklerinizi yetkilendirmek için bunları kullanın.
Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi için OAuth 2.0 kullanma kılavuzu.
Kimlik doğrulama türünüzü belirleme
Kimlik doğrulama türü | Açıklama |
---|---|
Hizmet Hesabı | Özel olarak kimlik doğrulaması yapmak istiyorsanız bunu seçin
bir kullanıcı hesabıyla oturum açın. . Daha fazla bilgi |
Web uygulaması | Herhangi bir kullanıcı olarak kimlik doğrulaması yapmak istiyorsanız bu seçeneği belirleyin.
uygulamanıza erişmesine izin veren
Ad Manager verileri. . Daha fazla bilgi |
Yerel gelişim | Kendi kimliğinizi doğrulamak istiyorsanız bunu seçin Yerel hesabınızın Google Hesabı veya Hizmet Hesabı ortamına taşıyabilirsiniz. |
Ad Manager API'sini etkinleştirme
Ad Manager API'yi Google API Konsolu Bulut Projesi.
İstenirse bir proje seçin veya yeni bir proje oluşturun.
Kimlik bilgileri oluştur
Kimlik doğrulama türünüze ait sekmeyi tıklayın ve talimatları uygulayarak kimlik bilgilerinizi oluşturun:
Hizmet Hesabı
Google Cloud'da
Google Cloud'da çalışan bir iş yükünün kimliğini doğrulamak için şunların kimlik bilgilerini kullanırsınız: kodunuzun bulunduğu bilgi işlem kaynağına bağlı hizmet hesabı çalışıyor.
Örneğin, bir hizmet hesabını Compute Engine sanal makinesine Cloud Run hizmeti veya Dataflow işi olabilir. Bu yaklaşım Google Cloud'da çalışan kod için tercih edilen kimlik doğrulama yöntemidir bilgi işlem kaynağı.
Hizmet hesabı ekleyebileceğiniz kaynaklar hakkında bilgi edinmek için ve hizmet hesabını kaynağa ekleme konusunda yardım almak için hizmet hesabı ekleme hakkındaki belgelere göz atın.
Şirket içinde veya farklı bir bulut sağlayıcıda
Google Cloud dışından kimlik doğrulamayı ayarlamak için tercih edilen yöntem:
iş yükü kimlik federasyonunu kullanmak için; bir
kimlik bilgisi yapılandırma dosyasını kullanarak GOOGLE_APPLICATION_CREDENTIALS
ortam değişkeninin gösterilmesini sağlar. Bu yaklaşım,
bir hizmet hesabı anahtarı oluşturun.
İş yükü kimliği federasyonunu yapılandıramıyorsanız bir hizmet hesabı ve hizmet hesabı için bir anahtar oluşturun:
Kimlik bilgileri sayfasında Kimlik bilgileri oluştur'u seçin ve ardından Hizmet Hesabı'nı seçin.
Oluşturmak istediğiniz hizmet hesabının e-posta adresini tıklayın çok önemli.
Keys (Anahtarlar) sekmesini tıklayın.
Anahtar ekle açılır menüsünü tıklayın, ardından Yeni anahtar oluştur'u seçin.
Anahtar türü olarak JSON'yi seçin ve Oluştur'u tıklayın.
GOOGLE_APPLICATION_CREDENTIALS
ortam değişkenini yola ayarlayın dışa aktarılmalıdır.
Linux veya macOS
export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Windows
set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Web uygulaması
İstenirse Ad Manager API'yi etkinleştirdiğiniz projeyi seçin.
Kimlik bilgileri sayfasında Kimlik bilgileri oluştur'u seçin ve ardından OAuth istemci kimliği'ni seçin.
Web uygulaması uygulama türünü seçin.
Formu doldurun ve Oluştur'u tıklayın. Diller ve PHP, Java, Python, Ruby ve .NET gibi çerçeveler yönlendirme URI'leri sağlamanız gerekir. Yönlendirme URI'leri, OAuth 2.0'ın yanıt gönderebilir. Bu uç noktalar, Google'ın doğrulama kurallarını inceleyin.
Kimlik bilgilerinizi oluşturduktan sonra client_secret.json dosyasını indirin. Dosyayı yalnızca uygulamanızın erişebileceği bir konumda güvenli bir şekilde depolayın.
Buradan, OAuth 2.0 erişim jetonları alma adımlarını uygulayın.
Yerel gelişim
Yerel ortamınızda Uygulama Varsayılan Kimlik Bilgilerini (ADC) ayarlayın.
Google Cloud KSA'yı yükleyin, ardından aşağıdaki komutu çalıştırarak CLI'yı başlatın komut:
gcloud init
Google Hesabınız için yerel kimlik doğrulama bilgileri oluşturun ve proje kimliğini Ad Manager API'sinin etkin olduğu bir projeye ekleyin:
gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
gcloud auth application-default set-quota-project PROJECT_ID
Alternatif olarak, ortamı ayarlamak için bir Hizmet Hesabı olarak kimlik doğrulaması yapın
GOOGLE_APPLICATION_CREDENTIALS
değişkenini anahtar dosyanızın yoluna eklemeniz gerekir.
Linux veya macOS
export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Windows
set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH
Ad Manager ağınızı yapılandırma
Hizmet Hesabı
- Ad Manager ağınıza gidin.
- Yönetici sekmesini tıklayın.
- API erişiminin etkinleştirildiğinden emin olun.
- Hizmet hesabı kullanıcısı ekle düğmesini tıklayın.
- Hizmet hesabı e-posta adresini kullanarak formu doldurun. İlgili içeriği oluşturmak için kullanılan hizmet hesabı kullanıcısı, uygun rollere ve ekiplere eklenmelidir API entegrasyonunuz için.
- Kaydet düğmesini tıklayın. Onaylayan bir mesaj gösterilir. hizmet hesabınızın eklenmesi.
- Kullanıcılar sekmesine gidip ardından mevcut hizmet hesabı kullanıcılarını görüntüleyin Hizmet Hesabı filtresini tıklayın.
Web uygulaması
- Ad Manager ağınıza gidin.
- Yönetici sekmesini tıklayın.
- API erişiminin etkinleştirildiğinden emin olun.
Yerel Geliştirme
- Ad Manager ağınıza gidin.
- Yönetici sekmesini tıklayın.
- API erişiminin etkinleştirildiğinden emin olun.
İstemci kitaplığı olmadan
İstemci kitaplığı kullanmıyorsanız yine de Kimlik doğrulama için bir OAuth2 kitaplığı.
Erişim jetonlarının alınmasıyla ilgili ayrıntılı talimatlar için Google API'leriyle OAuth2'yi kullanma.
Erişim jetonları
API'ye yapılan bir isteğe erişim jetonunuzu
access_token
sorgu parametresi veya Authorization
HTTP üst bilgisi Bearer
değeri.
Mümkün olduğunda HTTP üstbilgisi tercih edilir, çünkü sorgu dizeleri
sunucu günlüklerinde görünür.
Örneğin:
GET /v1/networks/1234
Host: admanager.googleapis.com
Authorization: Bearer ya29.a0Ad52N3_shYLX
GET https://admanager.googleapis.com/v1/networks/1234?access_token=1/fFAGRNJru1FTz70BzhT3Zg
Kapsam
Her erişim jetonu bir veya daha fazla kapsamla ilişkilendirilir. Kapsam, projenin bir erişim jetonunun izin verdiği kaynak ve işlemler kümesidir. Ad Manager REST API'nin yalnızca bir kapsamı vardır. Yetkilendirme, kullanıcı bir beceri düzeyidir.
Kapsam | İzinler |
---|---|
https://www.googleapis.com/auth/admanager
|
Kampanyalarınızı görüntüleyin ve yönetin Google Ad Manager'da. |