Bu belgede, Google Workspace Events API'ye özel yetkilendirme ve kimlik doğrulama bilgileri bulunmaktadır. Bu dokümanı okumadan önce Kimlik doğrulama ve yetkilendirme hakkında bilgi edinin başlıklı makaleden Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuduğunuzdan emin olun.
Yetkilendirme için OAuth 2.0'ı yapılandırın
OAuth izin ekranını yapılandırıp kapsamları seçerek kullanıcılara ve uygulama inceleme uzmanlarına gösterilecek bilgileri tanımlayın ve 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ı tanımlamanız ve bildirmeniz gerekir. Yetkilendirme kapsamı, Google Workspace uygulamasının adını, eriştiği verilerin türünü ve erişim düzeyini içeren bir OAuth 2.0 URI dizesidir. Kapsamlar, uygulamanızın Google Workspace verileriyle (kullanıcıların Google Hesabı verileri dahil) çalışma istekleridir.
Uygulamanız yüklendiğinde kullanıcıdan uygulama tarafından kullanılan kapsamları doğrulaması istenir. Genel olarak, mümkün olan en dar kapsamlı olarak odaklanmış kapsamı seçmeniz ve uygulamanızın gerektirmediği kapsamları talep etmekten kaçınmanız gerekir. Kullanıcılar sınırlı, net bir şekilde açıklanan kapsamlara daha kolay bir şekilde erişim izni verir.
Mümkün olduğunda, dosya başına erişim kapsamı verdiği ve bir uygulamanın ihtiyaç duyduğu belirli işlevlere erişimi daralttığı için hassas olmayan kapsamları kullanmanızı öneririz.
Google Workspace Etkinlikleri API'si, abonelikleri destekleyen Google Workspace uygulamalarındaki kapsamları kullanır. Uygulamanız zaten aboneliğiniz için gerekli olan kapsamları kullanıyorsa Google Workspace Etkinlikler API'sini kullanmak için ek kapsamlar eklemenize gerek yoktur.
Aşağıdaki tabloda Google Workspace Etkinlikleri API'si 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 sağlar. | Hassas değil | ||
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şturup 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 sohbetleri ve alanları görüntüleme. | Hassas |
||
https://www.googleapis.com/auth/chat.messages.reaction sn |
Chat'te mesajlara tepki ekleyin, verilen tepkileri görüntüleyin 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ıtlı | ||
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, uygulamanız tarafından oluşturulan toplantı alanlarıyla ilgili meta veriler 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 tabloda yer alan Kullanım sütunu, aşağıdaki tanımlara göre her kapsamın hassasiyetini gösterir:
Hassas değildir: Bu kapsamlar, en küçük yetkilendirme erişimi kapsamını sunar ve yalnızca temel uygulama doğrulaması gerektirir. Bu gereksinim hakkında bilgi edinmek için Doğrulama işlemine hazırlanma adımları bölümüne bakın.
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ğrulama sürecinden geçmeniz gerekir. Bu gereksinim hakkında bilgi edinmek için Hassas kapsamlar isteyen uygulamalara yönelik adımlar bölümüne bakın
Kısıtlanmış: Bu kapsamlar, Google Kullanıcı Verileri'ne geniş erişim sağlar ve kısıtlanmış bir kapsam doğrulama sürecinden geçmenizi gerektirir. Bu gereksinim hakkında daha fazla bilgi edinmek için Google API Hizmetleri: Kullanıcı Verileri Politikası ve Belirli API Kapsamları İçin Ek Gereksinimler bölümlerine göz atın. Kısıtlanmış kapsam verilerini sunucularda depoluyorsanız (veya iletiyorsanız) bir güvenlik değerlendirmesinden geçmeniz gerekir.
Uygulamanızın başka herhangi bir Google API'sine 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 bölümüne bakın.
Belirli OAuth 2.0 kapsamları hakkında daha fazla bilgi edinmek için Google API'leri için OAuth 2.0 Kapsamları bölümüne bakın.
OAuth doğrulaması
Belirli OAuth kapsamlarını kullanmak, uygulamanızın Google'ın OAuth doğrulama sürecinden geçmesini gerektirebilir. Uygulamanızın ne zaman doğrulamadan geçmesi gerektiğini ve ne tür doğrulamanın gerekli olduğunu belirlemek için OAuth API doğrulamasıyla ilgili SSS bölümünü okuyun. Google Drive Ek Hizmet Şartları'nı da inceleyin.
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 sunulmaktadır.
Google Workspace Etkinlikleri API'si, Google Chat etkinliklerine yönelik aboneliklerden bazılarını ç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, subscriptions.list()
yöntemini kullanıcı kimlik doğrulamasıyla çağırırsanız API, kimliği doğrulanmış kullanıcının erişebildiği aboneliklerin bir listesini döndürür. Uygulama kimlik doğrulamasını kullanırsanız API, uygulamanın erişebildiği aboneliklerin bir 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 Etkinlikleri API yöntemi için hangi kapsamların ve kimlik doğrulama türlerinin gerekli veya desteklendiği gösterilmektedir:
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ıyla bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulaması etkinken (yalnızca Google Chat uygulamaları):
|
|||
Abonelikleri listeleyin |
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ı etkinken (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ıyla bu yöntem, abonelik için en az bir etkinlik türünü destekleyen bir kapsam gerektirir.
Uygulama kimlik doğrulaması etkinken (yalnızca Google Chat uygulamaları):
|
Etkinlik türüne göre kapsamlar
Kullanıcı kimlik doğrulamasını kullanarak Google Workspace Etkinlikleri API'sini ç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 bir 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üncellenir. |
|
|
||||||
Bir tepki eklenir, silinir veya birden fazla tepki değiştirilir. |
|
|
||||||
Bir üyelik oluşturulur, güncellenir veya kaldırılır ya da birden fazla üyelik değiştirilir. |
|
|
||||||
Bir alan güncellenir veya silinir. |
|
|
||||||
Google Meet | ||||||||
Bir konferans başlar veya biter. |
|
|
||||||
Bir katılımcı konferansa katılır veya konferanstan ayrılır. |
|
|
||||||
Kayıt oluşturuldu. |
|
|
||||||
Bir transkript oluşturuldu. |
|
|