Google Workspace Events API kapsamlarını seçme

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:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
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ı):

  • chat.bot
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ı):

  • chat.bot
Aboneliği güncelleme

Her etkinlik türü için desteklenen bir kapsam gerektirir:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
Aboneliği yeniden etkinleştirme

Her etkinlik türü için desteklenen bir kapsam gerektirir:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
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ı):

  • chat.bot

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.
  • google.workspace.chat.message.v1.created
  • google.workspace.chat.message.v1.updated
  • chat.messages
  • chat.messages.readonly
Bir tepki eklenir veya silinir ya da birden fazla tepki değiştirilir.
  • google.workspace.chat.reaction.v1.created
  • google.workspace.chat.reaction.v1.deleted
  • google.workspace.chat.reaction.v1.batchChanged
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.messages
  • chat.messages.readonly
Üyelik oluşturulduğunda, güncellendiğinde veya kaldırıldığında ya da birden fazla üyelik emin olun.
  • google.workspace.chat.membership.v1.created
  • google.workspace.chat.membership.v1.updated
  • google.workspace.chat.membership.v1.deleted
  • google.workspace.chat.membership.v1.batchChanged
  • chat.memberships
  • chat.memberships.readonly
Bir alan güncellenir veya silinir.
  • google.workspace.chat.space.v1.updated
  • google.workspace.chat.space.v1.deleted
  • chat.spaces
  • chat.spaces.readonly
Google Meet  
Bir konferans başladığında veya sona erdiğinde.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended
  • meetings.space.created
  • meetings.space.readonly
Bir katılımcı bir konferansa katılır veya konferanstan ayrılırsa.
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left
  • meetings.space.created
  • meetings.space.readonly
Bir kayıt oluşturuldu.
  • google.workspace.meet.recording.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly
Bir transkript oluşturuldu.
  • google.workspace.meet.transcript.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly