Bu dokümanda, Google Workspace Events API'ye özel yetkilendirme ve kimlik doğrulama bilgileri yer alır. Bu dokümanı okumadan önce Kimlik doğrulama ve yetkilendirme hakkında bilgi başlıklı makalede Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuyun.
Yetkilendirme için OAuth 2.0'ı yapılandırma
Kullanıcılara ve uygulama incelemecilerine hangi bilgilerin gösterileceğini tanımlamak ve uygulamanızı daha sonra yayınlayabilmek için kaydetmek üzere OAuth kullanıcı rızası ekranını yapılandırın ve kapsamları seçin.
Google Workspace Events API kapsamları
Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını tanımlamanız ve 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 gönderdiği isteklerdir.
Uygulamanız yüklendiğinde kullanıcıdan, uygulamanın kullandığı kapsamları doğrulaması istenir. Genellikle, mümkün olan en dar kapsamı seçmeniz ve uygulamanızın gerektirmediği kapsamları istemekten kaçınmanız gerekir. Kullanıcılar, sınırlı ve açıkça tanımlanmış kapsamlara daha kolay erişim izni verir.
Google Workspace Events API, abonelikleri destekleyen Google Workspace uygulamalarındaki kapsamları kullanır. Uygulamanız aboneliğiniz için gereken kapsamları zaten kullanıyorsa Google Workspace Events API'yi kullanmak için kapsam eklemeniz gerekmez. Kapsam ekleyecekseniz uygulamanızın çalışmaya devam etmesini sağlayan en az hassas kapsamı seçin. Kapsam kategorileri hakkında ayrıntılı bilgi için Kapsam kategorileri başlıklı makaleyi inceleyin.
Aşağıdaki tabloda, Google Workspace Events API için desteklenen kapsamlar listelenmiştir:
| Kapsam kodu | Açıklama | Kullanım | ||
|---|---|---|---|---|
| Google Chat | ||||
https://www.googleapis.com/auth/chat.bot |
Chat uygulamalarının sohbetleri görüntülemesine ve mesaj göndermesine olanak tanır. Chat uygulamalarının tüm özelliklerine erişim sağlar. | Hassas olmayan | ||
https://www.googleapis.com/auth/chat.memberships |
Chat görüşmelerindeki üyeleri görüntüleme, ekleme ve kaldırma | Hassas |
||
https://www.googleapis.com/auth/chat.memberships.readonly |
Chat görüşmelerindeki üyeleri görüntüleme | Hassas |
||
https://www.googleapis.com/auth/chat.app.memberships |
Chat uygulamasında, Chat'teki görüşmelerde ve alanlarda üyeleri görme, ekleme, güncelleme ve kaldırma Yönetici onayı gerekir. Bu kapsam, yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması yapamazsınız. |
Hassas |
||
https://www.googleapis.com/auth/chat.app.memberships.readonly |
Google Chat'teki görüşmelerde ve alanlarda üyeleri Chat uygulaması olarak görme Yönetici onayı gerekir. Bu kapsam, yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması yapamazsınız. |
Hassas |
||
https://www.googleapis.com/auth/chat.spaces |
Chat'te görüşme ve alan oluşturmanın yanı sıra meta verileri (geçmiş ayarları dahil) görüntüleme veya güncelleme | Hassas | ||
https://www.googleapis.com/auth/chat.spaces.readonly |
Chat'te sohbet ve alanları görüntüleme | Hassas |
||
https://www.googleapis.com/auth/chat.app.spaces |
Chat'te bir Chat uygulaması olarak görüşmeler ve alanlar oluşturma ve meta verileri (geçmiş ayarları dahil) görüntüleme veya güncelleme Yönetici onayı gerekir. Bu kapsam, yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması yapamazsınız. |
Hassas |
||
https://www.googleapis.com/auth/chat.app.spaces.readonly |
Google Chat'te meta verileri (geçmiş ayarları dahil) Chat uygulaması olarak görüntüleme Yönetici onayı gerekir. Bu kapsam, yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması yapamazsınız. |
Hassas |
||
https://www.googleapis.com/auth/chat.messages.reactions |
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 |
Chat'te mesajları ve tepkileri görüntüleme | Kısıtlı |
||
https://www.googleapis.com/auth/chat.app.messages.readonly |
Chat'te mesajları ve tepkileri Chat uygulaması olarak görüntüleme Yönetici onayı gerekir. Bu kapsam, yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması yapamazsınız. |
Kısıtlı |
||
https://www.googleapis.com/auth/chat.users.readstate |
Chat'te kullanıcı okuma durumunu görüntüleme ve güncelleme | Hassas |
||
https://www.googleapis.com/auth/chat.users.readstate.readonly |
Chat'te kullanıcı okuma durumunu görüntüleme | Hassas |
||
https://www.googleapis.com/auth/chat.users.availability |
Chat'te müsaitlik durumunu görüntüleme ve değiştirme | Hassas |
||
https://www.googleapis.com/auth/chat.users.availability.readonly |
Chat'te müsaitlik durumunu görüntüleme | Hassas |
||
https://www.googleapis.com/auth/chat.app.all.spaces.readonly |
Chat uygulaması üye olmasa bile Google Workspace kuruluşunuzdaki tüm alanlar ve Google Chat'teki görüşmelerle ilgili meta verileri görüntüleyebilir. Bu kapsam yalnızca müşteri aboneliklerinde desteklenir. Yönetici onayı gerekir. Bu kapsam, yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması yapamazsınız. |
Kısıtlanmış | ||
https://www.googleapis.com/auth/chat.app.all.memberships.readonly |
Chat uygulaması üye olmasa bile Google Workspace kuruluşunuzdaki Google Chat alanları ve görüşmelerindeki tüm üyeleri görüntüleme Bu kapsam yalnızca müşteri aboneliklerinde desteklenir. Yönetici onayı gerekir. Bu kapsam, yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması yapamazsınız. |
Kısıtlanmış | ||
https://www.googleapis.com/auth/chat.app.all.messages.readonly |
Chat uygulaması bir alanın veya görüşmenin üyesi olmasa bile Google Workspace kuruluşunuzdaki tüm mesajları ve tepkileri görüntüleme Bu kapsam yalnızca müşteri aboneliklerinde desteklenir. Yönetici onayı gerekir. Bu kapsam, yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması yapamazsınız. |
Kısıtlanmış | ||
https://www.googleapis.com/auth/chat.app.all.users.readstate.readonly |
Chat uygulaması üye olmasa bile Google Workspace kuruluşunuzdaki tüm alan ve görüşmelerde tüm kullanıcıların son okunma zamanını görüntüleme Bu kapsam yalnızca müşteri aboneliklerinde desteklenir. Yönetici onayı gerekir. Bu kapsam, yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması yapamazsınız. |
Kısıtlanmış | ||
| Google Drive | ||||
https://www.googleapis.com/auth/drive.file |
Bir uygulamayla açtığınız veya kullanıcının Google Picker API'yi ya da uygulamanın dosya seçicisini kullanırken bir uygulamayla paylaştığı yeni Drive dosyaları oluşturma veya mevcut dosyaları değiştirme | 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üleme ve indirme | 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üleme | 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 veriler oluşturmasına, bunları 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 tabloda yer alan Kullanım sütunu, her bir kapsamın hassasiyetini gösterir:
Hassas olmayan: Bu kapsamlar, en küçük yetkilendirme erişimi kapsamını 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ı tarafından uygulamanız için yetkilendirilen belirli Google kullanıcı verilerine erişim sağlar. Ek uygulama doğrulama sürecinden geçmeniz gerekir. Bu şartla ilgili bilgi 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 Şartlar başlıklı makaleleri inceleyin. Kısıtlanmış kapsam verilerini sunucularda depoluyorsanız (veya aktarıyorsanı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 iç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ı kullanmak için uygulamanızın OAuth Uygulama Doğrulaması Yardım Merkezi'ndeki adımları uygulaması gerekebilir. Uygulamanızın ne zaman doğrulamadan geçmesi gerektiğini ve ne tür bir doğrulamanın gerekli olduğunu belirlemek için OAuth uygulamasıyla ilgili SSS bölümünü okuyun. 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.
Chat etkinliklerine abonelikler için Google Workspace Events API, bazı yöntemlerini çağırmak üzere 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 bilgisinin 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 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 Chat uygulamaları) | Desteklenen yetkilendirme kapsamları | |
|---|---|---|---|---|
| Abonelik oluşturma | — |
Kullanıcı kimlik doğrulamasıyla, her etkinlik türü için desteklenen bir kapsam gerekir:
Uygulama kimlik doğrulaması ve yönetici onayı (yalnızca Google Chat uygulamaları) ile her etkinlik türü için desteklenen bir kapsam gerekir:
|
||
| Abone olma |
Kullanıcı kimlik doğrulamasıyla birlikte bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulamasıyla (yalnızca Chat uygulamaları):
|
|||
| Abonelikleri listeleme |
Kullanıcı kimlik doğrulamasıyla birlikte bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulamasıyla (yalnızca Chat uygulamaları):
|
|||
| Abonelik güncelleme | — |
Kullanıcı kimlik doğrulamasıyla, her etkinlik türü için desteklenen bir kapsam gerekir:
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:
Uygulama kimlik doğrulaması ve yönetici onayı (yalnızca Chat uygulamaları) ile her etkinlik türü için desteklenen bir kapsam gerekir:
|
||
| Abonelik silme |
Kullanıcı kimlik doğrulamasıyla birlikte bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulamasıyla (yalnızca Chat uygulamaları):
|
|||
Etkinlik türüne göre kapsamlar
Google Workspace Events API'yi kullanıcı kimlik doğrulamasıyla çağırırken 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 desteklenen yetkilendirme kapsamları gösterilmektedir:
| Etkinlikler | Etkinlik türleri | Desteklenen yetkilendirme kapsamları | ||||||
|---|---|---|---|---|---|---|---|---|
| Chat | ||||||||
| Bir mesaj yayınlandığında veya güncellendiğinde. |
|
Kullanıcı kimlik doğrulaması ile:
|
||||||
| Tepki eklendiğinde veya silindiğinde ya da birden fazla tepki değiştirildiğinde |
|
Kullanıcı kimlik doğrulaması ile:
|
||||||
| Bir ü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:
|
||||||
| Kullanıcının alan okuma durumu veya mesaj dizisi okuma durumu güncellendiğinde. |
|
Kullanıcı kimlik doğrulaması ile:
|
||||||
| Bir müsaitlik durumu güncellendiğinde. |
|
Kullanıcı kimlik doğrulaması ile:
|
||||||
| Drive | ||||||||
| Bir dosya oluşturulduğunda, değiştirildiğinde, taşındığında, silindiğinde, yeniden adlandırıldığında, çöp kutusuna gönderildiğinde veya çöp kutusundan kaldırıldığında. |
|
|
||||||
| Bir dosyada erişim teklifi oluşturulduğunda veya çözüldüğünde. |
|
|
||||||
| Bir dosyadaki onay iptal edildiğinde, tamamlandığında, oluşturulduğunda, sıfırlandığında, inceleme uzmanları değiştirildiğinde veya inceleme uzmanları yanıt verdiğinde. |
|
|
||||||
| Bir dosyada yorum oluşturulduğunda, silindiğinde, düzenlendiğinde, yeniden açıldığında veya çözüme kavuşturulduğunda. |
|
|
||||||
| Bir dosyada yanıt oluşturulduğunda, silindiğinde veya düzenlendiğinde. |
|
|
||||||
| Bir dosyada izin oluşturulduğunda, silindiğinde veya düzenlendiğinde. |
|
|
||||||
| Meet | ||||||||
| Bir konferans başladığında veya bittiğinde. |
|
|
||||||
| Bir katılımcı konferansa katıldığında veya konferanstan ayrıldığında |
|
|
||||||
| Kayıt oluşturuldu. |
|
|
||||||
| Transkript oluşturuldu. |
|
|
||||||