Bu doküman, Google Workspace Events API'ye özel yetkilendirme içeriyor ve kimlik doğrulama bilgileri. Bu belgeyi okumadan önce Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgileri, Kimlik doğrulama ve yetkilendirme hakkında bilgi edinin.
Yetkilendirme için OAuth 2.0'ı yapılandırma
OAuth izin ekranını yapılandırma ve kapsamları seçme kullanıcılara ve uygulama incelemecilerine hangi bilgilerin görüntüleneceğini tanımlamak ve böylece daha sonra yayınlayabilirsiniz.
Google Workspace Events API kapsamları
Uygulamanıza verilen erişim düzeyini tanımlamak için şunları belirlemeniz gerekir: yetkilendirme kapsamlarını beyan etmeniz gerekir. Yetkilendirme kapsamı, OAuth 2.0 URI dizesidir erişim denetimi ve erişim izni verme erişim düzeyi olabilir. Kapsamlar, uygulamanızın aşağıdakiler de dahil olmak üzere Google Workspace verileriyle çalışma istekleridir: kullanıcıların Google Hesabı verileri.
Uygulamanız yüklenirken kullanıcıdan kullanılan kapsamları doğrulaması istenir elde edebiliyorlar. Genellikle, en dar odaklı kapsamı seçmeniz gerekir. Ayrıca, uygulamanızın gerektirmediği kapsamları istemekten kaçının. Daha fazla kullanıcı ve açıkça tanımlanmış sınırlı kapsamlara kolayca erişim izni verebilir.
Mümkün olduğunda, dosya başına izin verdiği için hassas olmayan kapsamları kullanmanızı öneririz ve uygulamanın ihtiyaç duyduğu belirli işlevlere erişimi daraltır.
Google Workspace Events API, Google Workspace'teki kapsamları kullanır uygulamaları kullanabilirsiniz. Uygulamanız zaten kapsamları kullanıyorsa daha fazla bilgi edinmek için kapsamlarının nasıl ayarlanacağını öğrenmeniz gerekir.
Aşağıdaki tabloda Google Workspace Events API:
| Kapsam kodu | Açıklama | Kullanım | ||
|---|---|---|---|---|
| Google Sohbet | ||||
https://www.googleapis.com/auth/chat.bot |
Google Chat uygulamalarının sohbetleri görüntülemesine ve mesaj göndermesine izin verir. Verir Chat uygulamalarında kullanılabilen tüm özelliklere erişebilir. | Hassas değil | ||
https://www.googleapis.com/auth/chat.memberships |
Google Chat'teki görüşmelerde üyeleri görüntüleme, ekleme veya 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şturup meta verileri (geçmiş ayarları dahil) görüntüleyin veya güncelleyin. | Hassas | ||
https://www.googleapis.com/auth/chat.spaces.readonly |
Google Chat'te sohbetleri ve alanları görüntüleyin. | Hassas |
||
https://www.googleapis.com/auth/chat.messages.reaction sn |
Chat'te mesajlara tepkileri görüntüleyin, ekleyin ve silin. | Hassas |
||
https://www.googleapis.com/auth/chat.messages.reactions.readonly |
Chat'te bir mesaja verilen tepkileri görüntüleyin. | 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üleyin. | Kısıtlı |
||
| Google Meet | ||||
https://www.googleapis.com/auth/meetings.space.created |
Uygulamaların, toplantı alanlarıyla ilgili meta verileri oluşturmasına, değiştirmesine ve okumasına izin verin otomatik olarak oluşturulur. | Hassas |
||
https://www.googleapis.com/auth/meetings.space.readonly |
Uygulamalara, kullanıcının erişebildiği tüm toplantı alanları hakkındaki meta verileri okuma izni verin. | Hassas |
||
Önceki tabloda yer alan Kullanım sütununda, her kapsamın hassasiyeti belirtilir. şu tanımlara göre:
Hassas değil: Bu kapsamlar, yapılandırmanın yetkilendirme erişimi sağlar ve yalnızca temel uygulama doğrulamasını gerektirir. Örneğin, daha fazla bilgi için doğrulama başlıklı makaleyi inceleyin.
Hassas: Bu kapsamlar, belirli Google Kullanıcı Verilerine erişim sağlar kullanıcı tarafından uygulamanız için yetkilendirilmiş olmalıdır. Projeyi tamamlamak için ek uygulama doğrulaması. Bu şartla ilgili bilgi için Adımlar hassas erişim izni isteyen uygulamalar için kapsamlar
Kısıtlanmış: Bu kapsamlar, Google Kullanıcı Verileri'ne kapsamlı erişim sağlar. ve kısıtlanmış kapsam doğrulama sürecinden geçmeniz gerekir. Örneğin, Google API Hizmetleri: Kullanıcı Verileri Politika ve Belirli API İçin Ek Gereksinimler Kapsamlar. Kısıtlanmış kapsam verilerini sunucularda depoluyorsanız (veya iletiyorsanız) güvenlik değerlendirmesinden geçmeniz gerekir.
Uygulamanız diğer Google API'lerine erişim gerektiriyorsa bu kapsamları ekleyebilirsiniz de faydalı olabilir. Google API kapsamları hakkında daha fazla bilgi için Aşağıdaki işlemleri gerçekleştirmek için OAuth 2.0'ı kullanma: Google API'lerine erişme
Belirli OAuth 2.0 kapsamları hakkında daha fazla bilgi için OAuth 2.0 kapsamları: Google API'leri.
OAuth doğrulaması
Belirli OAuth kapsamlarının kullanılması, uygulamanızın Google'ın OAuth doğrulaması işlemi hakkında daha fazla bilgi edinin. OAuth API doğrulamasını okuyun SSS uygulamanızın doğrulama sürecinden ne zaman geçmesi gerektiğini ve doğrulama gerekiyor. Ayrıca bkz. Google Drive Ek Şartları Hizmet.
Gerekli kimlik doğrulama türleri
Bu bölümde, hangi kimlik doğrulama türlerinin gerekli olduğu veya desteklendiği, ve yapılandırmanın her yöntemi için desteklenen kapsamları Google Workspace Events API.
Google Chat etkinliklerine ait abonelikler için Google Workspace Events API
yöntemlerinden bazılarını çağırmak için hem kullanıcı hem de uygulama kimlik doğrulamasını destekler. API
yöntem, çağrıda kullanılan kimlik bilgilerinin türü olan her iki kimlik bilgisini de destekler
döndürülen sonucu etkiler. Örneğin,
subscriptions.list()
yöntemini kullanıyorsanız API, kullanıcı kimlik doğrulamasından emin olmak için
kimliği doğrulanmış kullanıcının erişebileceği anlamına gelir. Uygulama kimlik doğrulamasını kullanıyorsanız API
uygulamanın erişebileceği aboneliklerin listesini döndürür. Şu konu hakkında daha fazla bilgi edinmek için:
Chat kimlik doğrulama türleri hakkında daha fazla bilgi için Kimlik doğrulama ve yetkilendirme
Chat uygulamaları ve Google Chat API
istekleri hakkında daha fazla bilgi edinin.
Aşağıdaki tabloda hangi kapsam ve türlerin Kimlik doğrulama her Google Workspace Events API'si için gerekli veya desteklenir yöntem:
| Yöntem | Kullanıcı kimlik doğrulaması gerekiyor 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 gerektirir:
|
||
| Abonelik edinme |
Kullanıcı kimlik doğrulaması söz konusu olduğunda bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulaması ile (yalnızca Google Chat uygulamaları):
|
|||
| Abonelikleri listeleyin |
Kullanıcı kimlik doğrulaması söz konusu olduğunda bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulaması ile (yalnızca Google Chat uygulamaları):
|
|||
| Aboneliği güncelleme | — |
Her etkinlik türü için desteklenen bir kapsam gerektirir:
|
||
| Aboneliği yeniden etkinleştirme | — |
Her etkinlik türü için desteklenen bir kapsam gerektirir:
|
||
| Aboneliği silme |
Kullanıcı kimlik doğrulaması söz konusu olduğunda bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulaması ile (yalnızca Google Chat uygulamaları):
|
|||
Etkinlik türüne göre kapsamlar
Kullanıcı kimlik doğrulamasını kullanarak Google Workspace Events API'yi çağırdığınızda abonelik.
Aşağıdaki tabloda, her bir kuruluş birimi için hangi yetkilendirme kapsamlarının desteklendiği gösterilir etkinlik türü:
| Etkinlikler | Etkinlik türleri | Desteklenen yetkilendirme kapsamları | ||||||
|---|---|---|---|---|---|---|---|---|
| Google Sohbet | ||||||||
| Bir mesaj yayınlandığında veya güncellendiğinde. |
|
|
||||||
| Bir 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 emin olun. |
|
|
||||||
| Bir alan güncellenir veya silinir. |
|
|
||||||
| Google Meet | ||||||||
| Bir konferans başladığında veya sona erdiğinde. |
|
|
||||||
| Bir katılımcı bir konferansa katılır veya konferanstan ayrılırsa. |
|
|
||||||
| Bir kayıt oluşturuldu. |
|
|
||||||
| Bir transkript oluşturuldu. |
|
|
||||||