İstemci kitaplıklarımız aşağıda belirtilen ayrıntıları otomatik olarak gerçekleştirir; bu sayede yalnızca, olayın arka planında olup bitenlerle ilgileniyorsanız veya istemci kitaplıklarımızdan birini kullanmıyorsanız bu dosyalarda görünür.
Bu bölüm, zaten aşina olan ileri düzey kullanıcılara yöneliktir. OAuth 2.0 spesifikasyonu ve OAuth2'nin Google API'leriyle nasıl kullanılacağını öğrenin.
API'de kimlik doğrulama hakkında daha fazla bilgi edinmek ister misiniz?
. Video kitaplığı: Kimlik Doğrulama ve Yetkilendirme
Kapsam
Tek bir erişim jetonu, birden fazla API'ye çeşitli düzeylerde erişim sağlayabilir. CEVAP
scope adlı değişken parametresi, kaynakları ve işlemleri kontrol eder
izin verir. Erişim jetonu isteği sırasında uygulamanız
scope parametresinde bir veya daha fazla değer gönderir.
Google Ads API'nin kapsamı:
https://www.googleapis.com/auth/adwords
Çevrimdışı erişim
Google Ads API istemci uygulamalarının çevrimdışı erişim istemesi yaygın bir durumdur. Örneğin, Uygulamanız, kullanıcı fiziksel olarak internete bağlı olmadığında toplu işler çalıştırmak isteyebilir yardımcı olabilir.
Bir web uygulaması türü için çevrimdışı erişim isteğinde bulunmak istiyorsanız
access_type parametresini offline öğesine bağlayın. Daha fazla bilgiyi şurada bulabilirsiniz:
Google'ın OAuth2 kılavuzu.
Masaüstü uygulaması türünde, çevrimdışı erişim varsayılan olarak etkindir. ve bunu açıkça talep etmek zorunda değildir.
İstek başlıkları
gRPC başlıkları
gRPC API'yi kullanırken her isteğe erişim jetonunu ekleyin. Şunları bağlayabilirsiniz:
Kanaldaki tüm isteklerde kullanılmak üzere Channel için bir Credential. Şunları yapabilirsiniz:
her çağrı için özelleştirilmiş bir kimlik bilgisi de gönderir. gRPC
Yetkilendirme kılavuzunda daha fazla bilgi bulabilirsiniz
ayrıntılarını inceleyin.
REST üstbilgileri
REST API kullanırken erişim jetonunu HTTP başlığı üzerinden iletin
Authorization Aşağıda örnek bir HTTP isteği gösterilmiştir:
GET /v17/customers/123456789 HTTP/2 Host: googleads.googleapis.com User-Agent: INSERT_USER_AGENT Accept: */* Authorization: Bearer INSERT_ACCESS_TOKEN developer-token: INSERT_DEVELOPER_TOKEN
Erişim ve yenileme jetonu
Çoğu durumda, yenileme jetonunu gelecekte kullanmak üzere güvenli bir şekilde saklamanız gerekir. Erişim isteğinde bulunma ve jeton yenileme işlemleri hakkında daha fazla bilgi edinmek için uygulama türünüzle ilgili kılavuza:
Yenileme jetonunun geçerlilik süresi
Yenileme jetonunun geçerlilik süresi hakkında daha fazla bilgi için Google Identity Platform OAuth dokümanlarına göz atın.
Erişim jetonunun geçerlilik süresi
Erişim jetonunun bir geçerlilik süresi vardır (
expires_in değeri) sonra
jeton artık geçerli değildir. Yenilemek için yenileme jetonunu kullanabilirsiniz
süresi dolmuş bir erişim jetonu. Varsayılan olarak istemci kitaplıklarımız otomatik olarak
süresi dolmuş erişim jetonlarını yenileme