Alanları listeleyin (original) (raw)

Bu kılavuzda, alanları listelemek için Google Chat API'nin Space kaynağında list() yönteminin nasıl kullanılacağı açıklanmaktadır. Listing spaces, sayfalandırılmış ve filtrelenebilir bir alan listesi döndürür.

Space Kaynağı, kullanıcıların ve Chat uygulamalarının mesaj gönderebileceği, dosya paylaşabileceği ve ortak çalışma yapabileceği bir yeri temsil eder. Birkaç tür alan vardır:

• Doğrudan mesajlar (DM), iki kullanıcı veya bir kullanıcı ile bir Chat uygulaması arasındaki görüşmelerdir.
• Grup sohbetleri, üç veya daha fazla kullanıcı ile sohbet uygulamaları arasındaki görüşmelerdir.
• Adlandırılmış alanlar, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalıştığı kalıcı yerlerdir.

Uygulama kimlik doğrulaması olan alanların listelendiği bu bölümde, Chat uygulamasının erişebildiği alanlar listelenir. Kullanıcı kimlik doğrulamasıile listeleme alanları, kimliği doğrulanmış kullanıcının erişebildiği alanları listeler.

Ön koşullar

Node.js

• Google Chat'e erişimi olan bir Business veya EnterpriseGoogle Workspace hesabı.
• Ortamınızı ayarlayın:
  • Google Cloud projesi oluşturun.
  • OAuth kullanıcı rızası ekranını yapılandırın.
  • Chat uygulamanız için ad, simge ve açıklama belirleyerek Google Chat API'yi etkinleştirin ve yapılandırın.
  • Node.js Cloud İstemci Kitaplığı'nı yükleyin.
  • Google Chat API isteğinizde kimlik doğrulaması yapmak istediğiniz yönteme göre erişim kimlik bilgileri oluşturun:
    * Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgileri oluşturun ve kimlik bilgilerini credentials.json adlı bir JSON dosyası olarak yerel dizininize kaydedin.
    * Chat uygulaması olarak kimlik doğrulamak için hizmet hesabı kimlik bilgileri oluşturun ve kimlik bilgilerini credentials.json adlı bir JSON dosyası olarak kaydedin.
• Kullanıcı veya Chat uygulaması olarak kimliğinizi doğrulamak isteyip istemediğinize bağlı olarak bir yetkilendirme kapsamı seçin.

Python

• Google Chat'e erişimi olan bir Business veya EnterpriseGoogle Workspace hesabı.
• Ortamınızı ayarlayın:
  • Google Cloud projesi oluşturun.
  • OAuth kullanıcı rızası ekranını yapılandırın.
  • Chat uygulamanız için ad, simge ve açıklama belirleyerek Google Chat API'yi etkinleştirin ve yapılandırın.
  • Python Cloud İstemci Kitaplığı'nı yükleyin.
  • Google Chat API isteğinizde kimlik doğrulaması yapmak istediğiniz yönteme göre erişim kimlik bilgileri oluşturun:
    * Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgileri oluşturun ve kimlik bilgilerini credentials.json adlı bir JSON dosyası olarak yerel dizininize kaydedin.
    * Chat uygulaması olarak kimlik doğrulamak için hizmet hesabı kimlik bilgileri oluşturun ve kimlik bilgilerini credentials.json adlı bir JSON dosyası olarak kaydedin.
• Kullanıcı veya Chat uygulaması olarak kimliğinizi doğrulamak isteyip istemediğinize bağlı olarak bir yetkilendirme kapsamı seçin.

Java

• Google Chat'e erişimi olan bir Business veya EnterpriseGoogle Workspace hesabı.
• Ortamınızı ayarlayın:
  • Google Cloud projesi oluşturun.
  • OAuth kullanıcı rızası ekranını yapılandırın.
  • Chat uygulamanız için ad, simge ve açıklama belirleyerek Google Chat API'yi etkinleştirin ve yapılandırın.
  • Java Cloud İstemci Kitaplığı'nı yükleyin.
  • Google Chat API isteğinizde kimlik doğrulaması yapmak istediğiniz yönteme göre erişim kimlik bilgileri oluşturun:
    * Chat kullanıcısı olarak kimlik doğrulamak için OAuth istemci kimliği kimlik bilgileri oluşturun ve kimlik bilgilerini credentials.json adlı bir JSON dosyası olarak yerel dizininize kaydedin.
    * Chat uygulaması olarak kimlik doğrulamak için hizmet hesabı kimlik bilgileri oluşturun ve kimlik bilgilerini credentials.json adlı bir JSON dosyası olarak kaydedin.
• Kullanıcı veya Chat uygulaması olarak kimliğinizi doğrulamak isteyip istemediğinize bağlı olarak bir yetkilendirme kapsamı seçin.

Apps Komut Dosyası

• Google Chat'e erişimi olan bir Business veya EnterpriseGoogle Workspace hesabı.
• Ortamınızı ayarlayın:
  • Google Cloud projesi oluşturun.
  • OAuth kullanıcı rızası ekranını yapılandırın.
  • Chat uygulamanız için ad, simge ve açıklama belirleyerek Google Chat API'yi etkinleştirin ve yapılandırın.
  • Bağımsız bir Apps Komut Dosyası projesi oluşturun ve Gelişmiş Chat Hizmeti'ni etkinleştirin.
  • Bu kılavuzda kullanıcı veya uygulama kimlik doğrulamasını kullanmanız gerekir. Sohbet uygulaması olarak kimlik doğrulamak için hizmet hesabı kimlik bilgileri oluşturun. Adımlar için Google Chat uygulaması olarak kimlik doğrulama ve yetkilendirme başlıklı makaleyi inceleyin.
• Kullanıcı veya Chat uygulaması olarak kimliğinizi doğrulamak isteyip istemediğinize bağlı olarak bir yetkilendirme kapsamı seçin.

Kullanıcı kimlik doğrulaması olan alanları listeleme

Google Chat'teki alanları listelemek için isteğinizde aşağıdakileri iletin:

• Kullanıcı kimlik doğrulaması ile chat.spaces.readonly veya chat.spaces yetkilendirme kapsamını belirtin.
• ListSpaces()yöntemini çağırın.

Aşağıdaki örnekte, kimliği doğrulanmış kullanıcının görebildiği adlandırılmış alanlar (ancak filtrelenen grup sohbetleri ve doğrudan mesajlar değil) listelenmektedir:

Node.js

Python

Java

Apps Komut Dosyası

Chat API, sayfalandırılmış bir alan listesi döndürür.

Uygulama kimlik doğrulamasıyla alanları listeleme

Google Chat'teki alanları listelemek için isteğinizde aşağıdakileri iletin:

• Uygulama kimlik doğrulaması ile chat.bot yetkilendirme kapsamını belirtin.
• ListSpaces()yöntemini çağırın.

Aşağıdaki örnekte, Chat uygulamasında görünen adlandırılmış alanlar (ancak grup sohbetleri ve doğrudan mesajlar değil) listelenmiştir:

Node.js

Python

Java

Apps Komut Dosyası

Chat API, sayfalandırılmış bir alan listesi döndürür.

Google Chat'teki alanları listelemek için aşağıdaki isteğe bağlı sorgu parametrelerini ileterek listelenen alanların sayfalandırmasını özelleştirin veya alanları filtreleyin:

• pageSize: Döndürülecek maksimum boşluk sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 100 boşluk döndürülür. Maksimum değer 1.000'dir. 1.000'den yüksek değerler otomatik olarak 1.000 olarak değiştirilir.
• pageToken: Önceki bir list spaces çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu jetonu sağlayın. Sayfalara ayırma işlemi yapılırken filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer iletmek beklenmedik sonuçlara yol açabilir.
• filter: Bir sorgu filtresi. Desteklenen sorgu ayrıntıları için ListSpacesRequest referansına bakın.
• Alan oluşturun.
• Alan oluşturma
• Bir alan hakkında ayrıntılı bilgi edinme
• Alan güncelleme.
• Alan silme
• Doğrudan mesaj alanını bulma