Package google.chat.v1

Dizin

ChatService

Geliştiricilerin Google Chat Platformu'nda Chat uygulamaları ve entegrasyonları oluşturmasına olanak tanır.

CompleteImportSpace

rpc CompleteImportSpace(CompleteImportSpaceRequest) returns (CompleteImportSpaceResponse)

Belirtilen alan için içe aktarma işlemini tamamlar ve alanı kullanıcılara görünür hâle getirir.

Yetkilendirme kapsamı ile kullanıcı kimlik doğrulaması ve alan genelinde yetki gerektirir:

  • https://www.googleapis.com/auth/chat.import

Daha fazla bilgi için Google Chat uygulamalarını veri içe aktarmak üzere yetkilendirme başlıklı makaleyi inceleyin.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/chat.import

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

CreateCustomEmoji

rpc CreateCustomEmoji(CreateCustomEmojiRequest) returns (CustomEmoji)

Özel emoji oluşturur.

Özel emojiler yalnızca Google Workspace hesaplarında kullanılabilir ve yöneticinin kuruluş için özel emojileri etkinleştirmesi gerekir. Daha fazla bilgi için Google Chat'teki özel emojiler hakkında ve Özel emoji izinlerini yönetme başlıklı makaleleri inceleyin.

Yetkilendirme kapsamı ile kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.customemojis
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/chat.customemojis

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership)

Arama için Chat uygulaması, kullanıcı veya Google Grubu için üyelik oluşturur. Diğer Chat uygulamaları için üyelik oluşturma desteklenmez. Üyelik oluştururken belirtilen üyenin otomatik kabul etme politikası devre dışıysa bu üye davet edilir ve katılmadan önce alan davetini kabul etmesi gerekir. Aksi takdirde, üyelik oluşturulduğunda üye doğrudan belirtilen alana eklenir.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Yönetici onayı ve yetkilendirme kapsamıyla uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.app.memberships
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (Arama uygulamasını alana eklemek için)
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)
    • Kullanıcı kimlik doğrulaması, bir yönetici hesabı kimlik doğruladığında, use_admin_access olduğunda ve aşağıdaki yetkilendirme kapsamı kullanıldığında yönetici ayrıcalıkları verir:
        true
      • https://www.googleapis.com/auth/chat.admin.memberships

Uygulama kimlik doğrulaması aşağıdaki kullanım alanlarında desteklenmez:

  • Alanın sahibi olan Workspace kuruluşunun dışındaki kullanıcıları davet etme
  • Alana Google Grubu ekleme
  • Alana Chat uygulaması ekleme

Örnek kullanım için bkz.:

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

CreateMessage

rpc CreateMessage(CreateMessageRequest) returns (Message)

Google Chat alanında mesaj oluşturur. Örnek için Mesaj gönderme başlıklı makaleye bakın.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Yetkilendirme kapsamıyla uygulama kimlik doğrulaması:
    • https://www.googleapis.com/auth/chat.bot
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:
    • https://www.googleapis.com/auth/chat.messages.create
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)

Chat, isteğinizde kullandığınız kimlik doğrulama türüne bağlı olarak ileti gönderenini farklı şekilde ilişkilendirir.

Aşağıdaki resimde, uygulama kimlik doğrulaması kullandığınızda Chat'in bir mesajı nasıl ilişkilendirdiği gösterilmektedir. Chat, mesaj göndereni Chat uygulaması olarak gösterir. Mesajın içeriğinde metin (text), kart (cardsV2) ve aksesuar widget'ları (accessoryWidgets) bulunabilir.

Uygulama kimlik doğrulamasıyla gönderilen ileti

Aşağıdaki resimde, kullanıcı kimlik doğrulamayı kullandığınızda Chat'in bir mesajı nasıl ilişkilendirdiği gösterilmektedir. Chat, kullanıcıyı mesaj gönderen olarak gösterir ve adını görüntüleyerek Chat uygulamasını mesajla ilişkilendirir. İleti içeriği yalnızca metin (text) içerebilir.

Kullanıcı kimlik doğrulamasıyla gönderilen ileti

İleti içeriği de dahil olmak üzere maksimum ileti boyutu 32.000 bayttır.

Webhook isteklerinde yanıt, mesajın tamamını içermiyor. Yanıt, istekte yer alan bilgilere ek olarak yalnızca name ve thread.name alanlarını dolduruyor.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

CreateReaction

rpc CreateReaction(CreateReactionRequest) returns (Reaction)

Tepki oluşturur ve mesaja ekler. Örnek için Mesaja tepki ekleme başlıklı makaleyi inceleyin.

Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.messages.reactions.create
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.create

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

CreateSpace

rpc CreateSpace(CreateSpaceRequest) returns (Space)

Alan oluşturur. Import mode'da adlandırılmış bir alan veya grup sohbeti oluşturmak için kullanılabilir. Örnek için Alan oluşturma başlıklı makaleyi inceleyin.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Yönetici onayı ve aşağıdaki yetkilendirme kapsamlarından biriyle uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.app.spaces.create
    • https://www.googleapis.com/auth/chat.app.spaces
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)

Uygulama olarak kimlik doğrulaması yapılırken istekte space.customer alanı ayarlanmalıdır.

Uygulama olarak kimlik doğrulandığında Chat uygulaması, alanın üyesi olarak eklenir. Ancak, kullanıcı kimlik doğrulamasından farklı olarak Chat uygulaması alan yöneticisi olarak eklenmez. Varsayılan olarak, Chat uygulaması tüm alan üyeleri tarafından alandan kaldırılabilir. Uygulamayı alandan yalnızca alan yöneticilerinin kaldırmasına izin vermek için space.permission_settings.manage_apps seçeneğini managers_allowed olarak ayarlayın.

Oluşturulduktan sonra alana üye olma durumu, alanın Import mode içinde oluşturulup oluşturulmadığına bağlıdır:

  • İçe aktarma modu: Üye oluşturulmaz.
  • Diğer tüm modlar: Arayan kullanıcı üye olarak eklenir. Bu:
    • Uygulama kimlik doğrulaması kullanılırken uygulamanın kendisi.
    • Kullanıcı kimlik doğrulaması kullanılırken insan kullanıcı.

Alan oluştururken ALREADY_EXISTS hata mesajını alırsanız farklı bir displayName kullanmayı deneyin. Google Workspace kuruluşundaki mevcut bir alan bu görünen adı kullanıyor olabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

DeleteCustomEmoji

rpc DeleteCustomEmoji(DeleteCustomEmojiRequest) returns (Empty)

Özel bir emojiyi siler. Varsayılan olarak, kullanıcılar yalnızca kendi oluşturdukları özel emojileri silebilir. Yönetici tarafından atanan emoji yöneticileri, kuruluştaki tüm özel emojileri silebilir. Google Chat'teki özel emojiler hakkında başlıklı makaleyi inceleyin.

Özel emojiler yalnızca Google Workspace hesaplarında kullanılabilir ve yöneticinin kuruluş için özel emojileri etkinleştirmesi gerekir. Daha fazla bilgi için Google Chat'teki özel emojiler hakkında ve Özel emoji izinlerini yönetme başlıklı makaleleri inceleyin.

Yetkilendirme kapsamı ile kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.customemojis
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/chat.customemojis

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership)

Üyeliği siler. Örnek için Bir kullanıcıyı veya Google Chat uygulamasını alandan kaldırma başlıklı makaleyi inceleyin.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Yönetici onayı ve yetkilendirme kapsamıyla uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.app.memberships
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (Arama uygulamasını alandan kaldırmak için)
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)
    • Kullanıcı kimlik doğrulaması, bir yönetici hesabı kimlik doğruladığında, use_admin_access olduğunda ve aşağıdaki yetkilendirme kapsamı kullanıldığında yönetici ayrıcalıkları verir:
        true
      • https://www.googleapis.com/auth/chat.admin.memberships

Uygulama kimlik doğrulaması aşağıdaki kullanım alanlarında desteklenmez:

  • Google Grubu'nu alandan çıkarma
  • Bir sohbet uygulamasını alandan kaldırma

Alan yöneticilerinin üyeliklerini silmek için isteği gönderen kullanıcının alan yöneticisi olması gerekir. Uygulama kimlik doğrulaması kullanıyorsanız alanı Chat uygulaması oluşturmalıdır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

DeleteMessage

rpc DeleteMessage(DeleteMessageRequest) returns (Empty)

Mesajı siler. Örnek için İleti silme başlıklı makaleyi inceleyin.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Yetkilendirme kapsamıyla uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.bot
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)

Uygulama kimlik doğrulaması kullanılırken istekler yalnızca arayan Chat uygulaması tarafından oluşturulan mesajları silebilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

DeleteReaction

rpc DeleteReaction(DeleteReactionRequest) returns (Empty)

Mesajlara verilen tepkileri siler. Örnek için Tepki silme başlıklı makaleyi inceleyin.

Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

DeleteSpace

rpc DeleteSpace(DeleteSpaceRequest) returns (Empty)

Adlandırılmış bir alanı siler. Her zaman kademeli silme işlemi gerçekleştirir. Bu nedenle, alanın alt kaynakları (ör. alanda yayınlanan mesajlar ve alandaki üyelikler) da silinir. Örnek için Alan silme başlıklı makaleyi inceleyin.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Yönetici onayı ve yetkilendirme kapsamıyla uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.app.delete (yalnızca uygulamanın oluşturduğu alanlarda)
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.delete
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)
    • Kullanıcı kimlik doğrulaması, bir yönetici hesabı kimlik doğruladığında, use_admin_access olduğunda ve aşağıdaki yetkilendirme kapsamı kullanıldığında yönetici ayrıcalıkları verir:
        true
      • https://www.googleapis.com/auth/chat.admin.delete
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.app.delete
  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

FindDirectMessage

rpc FindDirectMessage(FindDirectMessageRequest) returns (Space)

Belirtilen kullanıcıyla mevcut doğrudan mesajı döndürür. Doğrudan mesaj alanı bulunamazsa 404 NOT_FOUND hatası döndürülür. Örnek için Doğrudan mesaj bulma başlıklı makaleyi inceleyin.

Uygulama kimlik doğrulaması ile belirtilen kullanıcı ve arayan Chat uygulaması arasındaki doğrudan mesaj alanını döndürür.

Kullanıcı kimlik doğrulaması ile belirtilen kullanıcı ile kimliği doğrulanmış kullanıcı arasındaki doğrudan mesaj alanını döndürür.

Aşağıdaki kimlik doğrulama türlerini destekler:

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

GetAttachment

rpc GetAttachment(GetAttachmentRequest) returns (Attachment)

İleti ekinin meta verilerini alır. Ek verileri, Media API kullanılarak getirilir. Örnek için İleti ekiyle ilgili meta verileri alma başlıklı makaleyi inceleyin.

Yetkilendirme kapsamı ile uygulama kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.bot
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/chat.bot

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

GetCustomEmoji

rpc GetCustomEmoji(GetCustomEmojiRequest) returns (CustomEmoji)

Özel emoji hakkında ayrıntılar döndürür.

Özel emojiler yalnızca Google Workspace hesaplarında kullanılabilir ve yöneticinin kuruluş için özel emojileri etkinleştirmesi gerekir. Daha fazla bilgi için Google Chat'teki özel emojiler hakkında ve Özel emoji izinlerini yönetme başlıklı makaleleri inceleyin.

Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.customemojis.readonly
  • https://www.googleapis.com/auth/chat.customemojis
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

Bir üyelikle ilgili ayrıntıları döndürür. Örnek için Kullanıcı veya Google Chat uygulaması üyeliği hakkında ayrıntılı bilgi edinme başlıklı makaleyi inceleyin.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Aşağıdaki yetkilendirme kapsamlarından biriyle uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.bot
    • https://www.googleapis.com/auth/chat.app.memberships (yönetici onayı gerekir)
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships
    • Kullanıcı kimlik doğrulaması, bir yönetici hesabı kimlik doğruladığında yönetici ayrıcalıkları verir, use_admin_access true olur ve aşağıdaki yetkilendirme kapsamlarından biri kullanılır:
      • https://www.googleapis.com/auth/chat.admin.memberships.readonly
      • https://www.googleapis.com/auth/chat.admin.memberships
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

GetMessage

rpc GetMessage(GetMessageRequest) returns (Message)

Bir iletiyle ilgili ayrıntıları döndürür. Örnek için İletiyle ilgili ayrıntıları alma başlıklı makaleyi inceleyin.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Aşağıdaki yetkilendirme kapsamlarından biriyle uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.bot: Bu yetkilendirme kapsamı kullanılırken bu yöntem, Chat uygulamasının erişebildiği mesajlarla ilgili ayrıntıları (ör. doğrudan mesajlar ve Chat uygulamasını çağıran eğik çizgi komutları) döndürür.
    • https://www.googleapis.com/auth/chat.app.messages.readonly Yönetici onayı ile (geliştirici önizlemesinde kullanılabilir). Bu kimlik doğrulama kapsamı kullanılırken bu yöntem, bir alandaki herkese açık iletiyle ilgili ayrıntıları döndürür.
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages

Not: Engellenen bir üyeden veya alandan gelen mesajı döndürebilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

GetSpace

rpc GetSpace(GetSpaceRequest) returns (Space)

Bir alanla ilgili ayrıntıları döndürür. Örnek için Bir alan hakkında ayrıntılı bilgi edinme başlıklı makaleyi inceleyin.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Aşağıdaki yetkilendirme kapsamlarından biriyle uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.bot
    • https://www.googleapis.com/auth/chat.app.spaces Yönetici onayıyla
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces
    • Kullanıcı kimlik doğrulaması, bir yönetici hesabı kimlik doğruladığında yönetici ayrıcalıkları verir, use_admin_access true olur ve aşağıdaki yetkilendirme kapsamlarından biri kullanılır:
      • https://www.googleapis.com/auth/chat.admin.spaces.readonly
      • https://www.googleapis.com/auth/chat.admin.spaces

Uygulama kimlik doğrulamasıyla ilgili sınırlamalar:

  • space.access_settings yalnızca chat.app.spaces kapsamı kullanılırken doldurulur.
  • space.predefind_permission_settings ve space.permission_settings yalnızca chat.app.spaces kapsamı kullanılırken ve yalnızca uygulamanın oluşturduğu alanlar için doldurulur.
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.app.spaces

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

GetSpaceEvent

rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent)

Google Chat alanındaki bir etkinliği döndürür. Etkinlik yükü, değişen kaynağın en son sürümünü içerir. Örneğin, yeni bir mesajla ilgili etkinlik isteğinde bulunursanız ancak mesaj daha sonra güncellenirse sunucu, etkinlik yükünde güncellenmiş Message kaynağını döndürür.

Not: Bu istek için permissionSettings alanı, Space etkinliği verilerinin Space nesnesinde döndürülmez.

İstenen verilerin okunması için uygun bir yetkilendirme kapsamıyla aşağıdaki kimlik doğrulama türlerini destekler:

  • Geliştirici Önizlemesi'nde aşağıdaki yetkilendirme kapsamlarından biriyle yönetici onayı içeren uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.app.spaces
    • https://www.googleapis.com/auth/chat.app.messages.readonly
    • https://www.googleapis.com/auth/chat.app.memberships
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.messages.reactions.readonly
    • https://www.googleapis.com/auth/chat.messages.reactions
    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships

Etkinlik alabilmek için kimliği doğrulanmış arayanın alanın üyesi olması gerekir.

Örnek için Google Chat alanındaki bir etkinlik hakkında ayrıntılı bilgi edinme başlıklı makaleyi inceleyin.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

GetSpaceNotificationSetting

rpc GetSpaceNotificationSetting(GetSpaceNotificationSettingRequest) returns (SpaceNotificationSetting)

Alan bildirim ayarını alır. Örnek için Arayanın alan bildirimi ayarını alma başlıklı makaleyi inceleyin.

Yetkilendirme kapsamı ile kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.users.spacesettings
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/chat.users.spacesettings

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

GetSpaceReadState

rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState)

Okunmuş ve okunmamış iletileri belirlemek için kullanılan, kullanıcının bir alandaki okunma durumuyla ilgili ayrıntıları döndürür. Örnek için Kullanıcının alan okuma durumu hakkında ayrıntılı bilgi edinme başlıklı makaleyi inceleyin.

Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.users.readstate.readonly
  • https://www.googleapis.com/auth/chat.users.readstate
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

GetThreadReadState

rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState)

Okunmuş ve okunmamış iletileri belirlemek için kullanılan, bir ileti dizisindeki kullanıcının okuma durumuyla ilgili ayrıntıları döndürür. Örnek için Kullanıcının ileti dizisini okuma durumu hakkında ayrıntılı bilgi edinme başlıklı makaleyi inceleyin.

Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.users.readstate.readonly
  • https://www.googleapis.com/auth/chat.users.readstate
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

ListCustomEmojis

rpc ListCustomEmojis(ListCustomEmojisRequest) returns (ListCustomEmojisResponse)

Kimliği doğrulanmış kullanıcının görebileceği özel emojileri listeler.

Özel emojiler yalnızca Google Workspace hesaplarında kullanılabilir ve yöneticinin kuruluş için özel emojileri etkinleştirmesi gerekir. Daha fazla bilgi için Google Chat'teki özel emojiler hakkında ve Özel emoji izinlerini yönetme başlıklı makaleleri inceleyin.

Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması gerektirir:

  • https://www.googleapis.com/auth/chat.customemojis.readonly
  • https://www.googleapis.com/auth/chat.customemojis
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

Bir alandaki üyelikleri listeler. Örnek için Bir alandaki kullanıcıları ve Google Chat uygulamalarını listeleme başlıklı makaleyi inceleyin. Uygulama kimlik doğrulaması ile üyelikleri listeleme, Chat uygulamasının erişebildiği alanlardaki üyelikleri listeler ancak kendi üyeliği de dahil olmak üzere Chat uygulaması üyeliklerini hariç tutar. Kullanıcı kimlik doğrulaması ile üyelikleri listeleme, kimliği doğrulanmış kullanıcının erişebildiği alanlardaki üyelikleri listeler.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Aşağıdaki yetkilendirme kapsamlarından biriyle uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.bot
    • https://www.googleapis.com/auth/chat.app.memberships (yönetici onayı gerekir)
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)
    • Kullanıcı kimlik doğrulaması, bir yönetici hesabı kimlik doğruladığında yönetici ayrıcalıkları verir, use_admin_access true olur ve aşağıdaki yetkilendirme kapsamlarından biri kullanılır:
      • https://www.googleapis.com/auth/chat.admin.memberships.readonly
      • https://www.googleapis.com/auth/chat.admin.memberships
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

ListMessages

rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse)

Arayanın üyesi olduğu bir alandaki mesajları (engellenen üyelerden ve alanlardan gelen mesajlar dahil) listeler. Yeni alan üyelerini duyuranlar gibi sistem mesajları dahil edilmez. Mesaj içermeyen bir alandaki mesajları listelerseniz yanıt boş bir nesne olur. REST/HTTP arayüzü kullanılırken yanıtta boş bir JSON nesnesi ({}) bulunur. Örnek için İletileri listeleme başlıklı makaleyi inceleyin.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Yetkilendirme kapsamıyla geliştirici önizlemesinde yönetici onayı ile uygulama kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.app.messages.readonly. Bu kimlik doğrulama kapsamı kullanılırken bu yöntem yalnızca bir alandaki herkese açık mesajları döndürür. Özel mesajlar bu kapsamda değildir.
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly

Daha fazla bilgi için