Aşağıdaki tabloda, bir uygulamanın yönetmesi gereken kimlik bilgileri özetlenmiştir. Uygulama türleri hakkında daha fazla bilgi için Google Identity OAuth 2.0 belgelerine bakın.
| Kimlik doğrulama iş akışı | Kimlik bilgisi | Kimlik bilgisi türü | Amaç |
|---|---|---|---|
|
JavaScript web uygulamaları Android uygulamaları |
OAuth istemci kimliği | Uygulama kimlik bilgileri | OAuth akışı sırasında uygulamayı benzersiz şekilde tanımlar. |
| Erişim jetonu ve yenileme jetonu | Kullanıcı kimlik bilgileri | Uygulamanın, kullanıcı adına Google Ads hesabına erişmesine izin veren kullanıcı yetkilendirmesini temsil eder. | |
|
Sunucu tarafı web uygulamaları Masaüstü ve iOS uygulamaları TV ve cihaz uygulamaları |
OAuth istemci kimliği ve istemci gizli anahtarı | Uygulama kimlik bilgileri | OAuth akışı sırasında uygulamayı benzersiz şekilde tanımlar. |
| Erişim jetonu ve yenileme jetonu | Kullanıcı kimlik bilgileri | Kullanıcının, uygulamanın kendi adına Google Ads hesabına erişmesine izin verdiğini gösterir. | |
| Hizmet hesapları | OAuth hizmet hesabı anahtarı | Uygulama kimlik bilgileri | OAuth isteğini imzalamak için kullanılır. |
| Hizmet hesabının erişim jetonu | Kullanıcı kimlik bilgileri | Bir kullanıcı Google Ads hesabını hizmet hesabıyla paylaştığında hizmet hesabının yetkilendirmesini temsil eder. |
Google Ads API uygulamasının kimlik bilgilerini yönetirken göz önünde bulundurmanız gereken birkaç nokta vardır.
Uygulama kimlik bilgilerini güvenli bir şekilde yönetme
Uygulama kimlik bilgileri, uygulamanıza özel olan ve kullanıcıdan kullanıcıya değişmeyen ayarları ifade eder. OAuth uygulama kimlik bilgilerinizi çok dikkatli bir şekilde kullanın. Bu bilgilere sahip olan herkes, uygulamanızın kimliğini kullanarak kullanıcı bilgilerine erişebilir. OAuth uygulama kimlik bilgilerinizi güvenli bir yerde saklayın ve şifre gibi koruyun. Mümkün olduğunda uygulama kimlik bilgilerini depolamak için Google Cloud Secret Manager gibi bir gizli anahtar yöneticisi kullanın. İstemci kimlik bilgilerini hiçbir zaman herkese açık kod depolarına yüklememelisiniz. Bu bilgileri herhangi bir kod deposuna kaydetmemenizi önemle tavsiye ederiz.
Kullanıcı kimlik bilgilerini güvenli bir şekilde işleme
Kullanıcı kimlik bilgileri, kullanıcının yetkilendirmesini temsil eden OAuth jetonlarını ifade eder. Bu veriler, uygulamanızı doğrudan kimliklendirerek veya Google Ads hesaplarını hizmet hesabınızla paylaşarak sizin adınıza işlem yapma ve verilere erişme izni veren kullanıcılar tarafından size emanet edilir. Jetonları hiçbir zaman düz metin olarak iletmeyin ve veri ihlali durumunda ekstra bir koruma katmanı sağlamak için şifrelenmiş jetonları her zaman aktif değilken depolayın. Bir kullanıcının hesabına erişmeniz gerekmediğinde jetonları veya hizmet hesabı izinlerini iptal edin. Jetonlar iptal edildikten sonra bunları uygulamanızdan veya sisteminizden kalıcı olarak silin.
Yenileme jetonunun iptalini ve geçerlilik süresinin dolmasını yönetme
Kullanıcı kimlik doğrulama akışı kullanıyorsanız yenileme jetonlarının herhangi bir zamanda geçersiz kılınabileceğini unutmayın. Örneğin, çok kullanıcılı bir kimlik doğrulama akışı kullanıyorsanız kullanıcı, uygulamanıza erişimi iptal etmeyi seçebilir. Tek kullanıcılı kimlik doğrulama akışı kullanan bir uygulamanın bu şekilde etkilenme olasılığı daha düşük olsa da kullanıcıları korumak için tasarlanmış manuel veya otomatik bir işlem, yenileme jetonunu temizleyebilir ya da yenileme jetonunun süresi dolabilir. Uygulamanız, kullanıcılara iyi bir deneyim sunmak için jeton iptali bildirimi gerektiriyorsa Hesaplar Arası Koruma hizmetiyle entegre etmeniz gerekir.
API isteklerinizde kullanıcı kimlik bilgilerini yeniden kullanma
OAuth erişim jetonları kısa ömürlüdür ve bir saat sonra geçerliliğini yitirir. Google Ads API istemci kitaplığı kullanıyorsanız kitaplık, erişim jetonunun süresinin dolmasını ve yenilenmesini iş parçacığı açısından güvenli bir şekilde yönetir. Uygun OAuth kimlik bilgileriyle bir Google Ads API istemci nesnesi oluşturun ve bu nesneyi kullanım ömrü boyunca yeniden kullanın.
Kendi erişim jetonu yenileme ve yönetim stratejinizi oluşturursanız erişim jetonunun geçerlilik bitimini izleyin ve jetonlar geçerli olduğu sürece bunları yeniden kullanın. Jeton yenileme isteğinde bulunduğunuzda yetkilendirme sunucusu, saniye cinsinden kalan kullanım süresi (expires_in) ile birlikte yeni bir erişim jetonu döndürür. Süre dolmadan 5 dakikadan az zaman kaldıysa erişim jetonunu proaktif olarak yenilemenizi öneririz.