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 kullanıcı rızası 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 bildirmeniz 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.app.memberships |
Google Chat'teki görüşmeler ve alanlarda üyeleri görme, ekleme, güncelleme ve kaldırma Yönetici onayı gerektirir. Bu kapsam yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde temsil ile kimlik doğrulama yapamazsınız. |
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.app.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 Yönetici onayı gerektirir. Bu kapsam yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde temsil ile kimlik doğrulama yapamazsınız. |
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ı |
||
https://www.googleapis.com/auth/chat.app.messages.readonly |
Google Chat'te mesajları ve tepkileri Chat uygulaması olarak görüntüleme Yönetici onayı gerektirir. Bu kapsam yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde temsil ile kimlik doğrulama yapamazsınız. |
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üleyip yönetebilirsiniz. | 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ü inceleyin. 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'nin bazı yöntemlerini çağırmak için hem kullanıcı hem de uygulama kimlik doğrulaması desteklenir. 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 | — |
Kullanıcı kimlik doğrulamasıyla, her etkinlik türü için desteklenen bir kapsam gerekir:
Geliştirici Önizlemesi: Uygulama kimlik doğrulaması ve yönetici onayı (yalnızca Google Chat uygulamaları) ile 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 | — |
Kullanıcı kimlik doğrulamasıyla, her etkinlik türü için desteklenen bir kapsam gerekir:
Geliştirici Önizlemesi: Uygulama kimlik doğrulaması ve yönetici onayı (yalnızca Google Chat uygulamaları) ile her etkinlik türü için desteklenen bir kapsam gerekir:
|
||
| Aboneliği yeniden etkinleştirme | — |
Kullanıcı kimlik doğrulamasıyla, her etkinlik türü için desteklenen bir kapsam gerekir:
Geliştirici Önizlemesi: Uygulama kimlik doğrulaması ve yönetici onayı (yalnızca Google Chat uygulamaları) ile 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 |
|
Kullanıcı kimlik doğrulaması ile:
|
||||||
| Tepki eklenir, silinir veya 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 |
|
Kullanıcı kimlik doğrulaması ile:
|
||||||
| Bir alan güncellendiğinde veya silindiğinde |
|
Kullanıcı kimlik doğrulaması ile:
|
||||||
| 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. |
|
|
||||||