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.
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 kapsam eklemeniz gerekmez. Kapsam ekliyorsanız uygulamanızın çalışmasına izin veren 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'nin desteklediği kapsamlar listelenmiştir:
| Kapsam kodu | Açıklama | Kullanım | ||
|---|---|---|---|---|
| Google Chat | ||||
https://www.googleapis.com/auth/chat.bot |
Lets Chat uygulamalarının sohbetleri görüntülemesine ve mesaj göndermesine izin verilir. Chat uygulamalarında kullanılabilen tüm özelliklere erişim izni verir. | Hassas olmayan | ||
https://www.googleapis.com/auth/chat.memberships |
Chat'teki görüşmelerde ü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ı olarak 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 |
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 |
Chat'te sohbet ve alanları görüntüleme | Hassas |
||
https://www.googleapis.com/auth/chat.app.spaces |
Chat uygulaması olarak 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 mesajlara 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ıtlandı |
||
https://www.googleapis.com/auth/chat.app.messages.readonly |
Chat uygulamasında mesajları ve tepkileri 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 |
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şturun veya mevcut dosyaları değiştirin. | 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 toplantı alanlarıyla ilgili meta verileri okumasına izin verin. | Hassas |
||
Yukarıdaki tablodaki Kullanım sütunu, her kapsamın hassasiyetini gösterir:
Hassas olmayan: Bu kapsamlar, yetkilendirme erişiminin en küçük 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, uygulamanız için kullanıcı tarafından yetkilendirilen 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'yi 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 abonelik 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 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 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:
Geliştirici Önizlemesi: Uygulama kimlik doğrulaması ve yönetici onayı (yalnızca 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 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 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 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 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 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ı | ||||||
|---|---|---|---|---|---|---|---|---|
| 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:
|
||||||
| Drive | ||||||||
| Bir dosya oluşturulduğunda, değiştirildiğinde, taşındığında, silindiğinde, yeniden adlandırıldığında, çöp kutusuna taşındığında veya çöp kutusundan kaldırıldığında |
|
|
||||||
| Bir dosyada Erişim Önerisi oluşturulur veya çözümlenir. |
|
|
||||||
| Bir dosyada onay iptal edildiğinde, tamamlandığında, oluşturulduğunda, sıfırlandığında, incelemeciler değiştirildiğinde veya incelemeciler yanıt verdiğinde |
|
|
||||||
| Bir dosyada yorum oluşturulduğunda, silindiğinde, düzenlendiğinde, yeniden açıldığında veya çözümlendiğinde |
|
|
||||||
| 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 | ||||||||
| Konferans başlatıldığı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. |
|
|
||||||