Bu belgede, Google Workspace Events API'ye özel yetkilendirme ve kimlik doğrulama bilgileri yer almaktadır. Bu belgeyi okumadan önce Kimlik doğrulama ve yetkilendirme hakkında bilgi başlıklı makalede Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuduğunuzdan emin olun.
Yetkilendirme için OAuth 2.0'ı yapılandırma
Kullanıcılara ve uygulama inceleyicilerine hangi bilgilerin gösterileceğini tanımlamak için OAuth izin ekranını yapılandırın ve kapsamları seçin. Ayrıca, uygulamanızı daha sonra yayınlayabilmek için kaydedin.
Google Workspace Events API kapsamları
Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını belirleyip beyan etmeniz gerekir. Yetkilendirme kapsamı, Google Workspace uygulama adını, eriştiği veri türünü ve erişim düzeyini içeren bir OAuth 2.0 URI dizesidir. Kapsamlar, uygulamanızın kullanıcıların Google Hesabı verileri de dahil olmak üzere Google Workspace verileriyle çalışmak için yaptığı isteklerdir.
Uygulamanız yüklendiğinde, kullanıcıdan uygulama tarafından kullanılan kapsamları doğrulaması istenir. Genellikle, mümkün olan en dar kapsamı seçmeli ve uygulamanızın gerektirmediği kapsamları istemekten kaçınmalısınız. Kullanıcılar, sınırlı ve net bir şekilde açıklanmış kapsamlara daha kolay erişim izni verir.
Mümkün olduğunda, dosya başına erişim kapsamı sağladığı ve erişimi bir uygulamanın ihtiyaç duyduğu belirli işlevlerle sınırladığı için hassas olmayan kapsamları kullanmanızı öneririz.
Google Workspace Events API, abonelikleri destekleyen Google Workspace uygulamalarındaki kapsamları kullanır. Uygulamanız aboneliğiniz için gerekli kapsamları zaten kullanıyorsa Google Workspace Events API'yi kullanmak için ek kapsamlar eklemeniz gerekmez.
Aşağıdaki tabloda, Google Workspace Events API için desteklenen kapsamlar gösterilmektedir:
| Kapsam kodu | Açıklama | Kullanım | ||
|---|---|---|---|---|
| Google Chat | ||||
https://www.googleapis.com/auth/chat.bot |
Google Chat uygulamalarının sohbetleri görüntülemesine ve mesaj göndermesine izin verir. Chat uygulamalarında kullanılabilen tüm özelliklere erişim izni verir. | Hassas olmayan | ||
https://www.googleapis.com/auth/chat.memberships |
Google Chat'teki görüşmelerde üyeleri görüntüleme, ekleme ve kaldırma | Hassas |
||
https://www.googleapis.com/auth/chat.memberships.readonly |
Google Chat görüşmelerindeki üyeleri görüntüler. | Hassas |
||
https://www.googleapis.com/auth/chat.spaces |
Google Chat'te görüşmeler ve alanlar oluşturma ve meta verileri (geçmiş ayarları dahil) görüntüleme veya güncelleme | Hassas | ||
https://www.googleapis.com/auth/chat.spaces.readonly |
Google Chat'te sohbet ve alanları görüntüleme | Hassas |
||
https://www.googleapis.com/auth/chat.messages.reaction sn |
Chat'te mesajlara tepki ekleme, tepkileri görüntüleme ve silme | Hassas |
||
https://www.googleapis.com/auth/chat.messages.reactions.readonly |
Chat'te bir mesaja verilen tepkileri görüntüleme | Hassas |
||
https://www.googleapis.com/auth/chat.messages |
Mesajları görüntüleme, oluşturma, gönderme, güncelleme ve silme; mesajlara tepki ekleme, verilen tepkileri görüntüleme ve silme. | Kısıtlanmış | ||
https://www.googleapis.com/auth/chat.messages.readonly |
Google Chat'te mesajları ve tepkileri görüntüleme | Kısıtlandı |
||
| Google Drive | ||||
https://www.googleapis.com/auth/drive.file |
Google Picker API'yi veya uygulamanın dosya seçicisini kullanırken bir uygulamayla açtığınız ya da kullanıcının bir uygulamayla paylaştığı mevcut dosyaları değiştirin veya yeni Drive dosyaları oluşturun. | Hassas olmayan | ||
https://www.googleapis.com/auth/drive |
Tüm Drive dosyalarınızı görüntüleme ve yönetme | Kısıtlanmış | ||
https://www.googleapis.com/auth/drive.readonly |
Tüm Drive dosyalarınızı görüntüleyip indirebilirsiniz. | Kısıtlanmış | ||
https://www.googleapis.com/auth/drive.metadata |
Drive'ınızdaki dosyaların meta verilerini görüntüleme ve yönetme | Kısıtlanmış | ||
https://www.googleapis.com/auth/drive.metadata.readonly |
Drive'ınızdaki dosyaların meta verilerini görüntüleyin. | Kısıtlanmış | ||
| Google Meet | ||||
https://www.googleapis.com/auth/meetings.space.created |
Uygulamaların, uygulamanız tarafından oluşturulan toplantı alanlarıyla ilgili meta verileri oluşturmasına, değiştirmesine ve okumasına izin verin. | Hassas |
||
https://www.googleapis.com/auth/meetings.space.readonly |
Uygulamaların, kullanıcının erişebildiği tüm toplantı alanlarıyla ilgili meta verileri okumasına izin verin. | Hassas |
||
Yukarıdaki tablodaki Kullanım sütunu, aşağıdaki tanımlara göre her kapsamın hassasiyetini gösterir:
Hassas olmayan: Bu kapsamlar, en küçük yetkilendirme kapsamı erişimini sağlar ve yalnızca temel uygulama doğrulaması gerektirir. Bu şartla ilgili bilgi için Doğrulama şartları başlıklı makaleyi inceleyin.
Hassas: Bu kapsamlar, kullanıcının uygulamanız için yetkilendirdiği belirli Google Kullanıcı Verilerine erişim sağlar. Ek uygulama doğrulamasından geçmeniz gerekir. Bu şart hakkında bilgi edinmek için Hassas ve Kısıtlanmış Kapsam Şartları başlıklı makaleyi inceleyin.
Kısıtlanmış: Bu kapsamlar, Google Kullanıcı Verilerine geniş erişim sağlar ve kısıtlanmış kapsam doğrulama sürecinden geçmenizi gerektirir. Bu şartla ilgili bilgi için Google API Hizmetleri: Kullanıcı Verileri Politikası ve Belirli API Kapsamları İçin Ek Gereksinimler başlıklı makaleleri inceleyin. Kısıtlanmış kapsam verilerini sunucularda saklıyorsanız (veya iletiyorsanız) güvenlik değerlendirmesinden geçmeniz gerekir.
Uygulamanızın başka Google API'lerine erişmesi gerekiyorsa bu kapsamları da ekleyebilirsiniz. Google API kapsamları hakkında daha fazla bilgi için Google API'lerine Erişmek İçin OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.
Belirli OAuth 2.0 kapsamları hakkında daha fazla bilgi için Google API'leri için OAuth 2.0 Kapsamları başlıklı makaleyi inceleyin.
OAuth doğrulaması
Belirli OAuth kapsamlarının kullanılması, uygulamanızın OAuth Uygulama Doğrulaması Yardım Merkezi'nden geçmesini gerektirebilir. Uygulamanızın ne zaman doğrulanması gerektiğini ve ne tür bir doğrulama gerektiğini belirlemek için OAuth uygulamasıyla ilgili SSS bölümünü okuyun. Google Drive Hizmet Şartları'na da göz atın.
Gerekli kimlik doğrulama türleri
Bu bölümde, hangi kimlik doğrulama türlerinin gerekli olduğu veya desteklendiği açıklanmakta ve Google Workspace Events API'nin her yöntemi için desteklenen kapsamlar sağlanmaktadır.
Google Chat etkinliklerine aboneliklerde, Google Workspace Events API bazı yöntemlerini çağırmak için hem kullanıcı hem de uygulama kimlik doğrulamasını destekler. Bir API yöntemi her iki kimlik bilgisini de destekliyorsa çağrıda kullanılan kimlik bilgisi türü, döndürülen sonucu etkiler. Örneğin, kullanıcı kimlik doğrulamasıyla subscriptions.list yöntemini çağırırsanız API, kimliği doğrulanmış kullanıcının erişebileceği aboneliklerin listesini döndürür. Uygulama kimlik doğrulaması kullanıyorsanız API, uygulamanın erişebileceği aboneliklerin listesini döndürür. Chat kimlik doğrulama türleri hakkında daha fazla bilgi edinmek için Chat uygulamaları ve Google Chat API isteklerinin kimliğini doğrulama ve yetkilendirme başlıklı makaleyi inceleyin.
Aşağıdaki tabloda, her bir Google Workspace Events API yöntemi için hangi kapsamların ve kimlik doğrulama türlerinin gerekli olduğu veya desteklendiği gösterilmektedir:
| Yöntem | Kullanıcı kimlik doğrulaması gerekli veya destekleniyor | Uygulama kimlik doğrulaması desteklenir (yalnızca Google Chat uygulamaları) | Desteklenen yetkilendirme kapsamları | |
|---|---|---|---|---|
| Abonelik oluşturma | — |
Her etkinlik türü için desteklenen bir kapsam gerekir:
|
||
| Abonelik edinme |
Kullanıcı kimlik doğrulamasıyla bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulamasıyla (yalnızca Google Chat uygulamaları):
|
|||
| Abonelikleri listeleme |
Kullanıcı kimlik doğrulamasıyla bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulamasıyla (yalnızca Google Chat uygulamaları):
|
|||
| Aboneliği güncelleme | — |
Her etkinlik türü için desteklenen bir kapsam gerekir:
|
||
| Aboneliği yeniden etkinleştirme | — |
Her etkinlik türü için desteklenen bir kapsam gerekir:
|
||
| Aboneliği silme |
Kullanıcı kimlik doğrulamasıyla bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulamasıyla (yalnızca Google Chat uygulamaları):
|
|||
Etkinlik türüne göre kapsamlar
Kullanıcı kimlik doğrulamasıyla Google Workspace Events API'yi çağırdığınızda aboneliğin etkinlik türlerine karşılık gelen bir veya daha fazla kapsam belirtmeniz gerekir.
Aşağıdaki tabloda, her etkinlik türü için hangi yetkilendirme kapsamlarının desteklendiği gösterilmektedir:
| Etkinlikler | Etkinlik türleri | Desteklenen yetkilendirme kapsamları | ||||||
|---|---|---|---|---|---|---|---|---|
| Google Chat | ||||||||
| Bir mesaj yayınlandığında veya güncellendiğinde |
|
|
||||||
| Tepki eklenir veya silinir ya da birden fazla tepki değiştirilir. |
|
|
||||||
| Üyelik oluşturulduğunda, güncellendiğinde veya kaldırıldığında ya da birden fazla üyelik değiştirildiğinde |
|
|
||||||
| Bir alan güncellendiğinde veya silindiğinde |
|
|
||||||
| Google Drive | ||||||||
| Dosya oluşturulduğunda, değiştirildiğinde, taşındığında, silindiğinde, çöp kutusuna taşındığında veya çöp kutusundan kaldırıldığında |
|
|
||||||
| Bir dosyada Erişim Önerisi oluşturulur veya çözümlenir. |
|
|
||||||
| Google Meet | ||||||||
| Bir konferans başladığında veya sona erdiğinde |
|
|
||||||
| Bir katılımcı konferansa katıldığında veya konferanstan ayrıldığında |
|
|
||||||
| Kayıt oluşturuldu. |
|
|
||||||
| Transkript oluşturuldu. |
|
|
||||||