Alan oluşturma

Bu kılavuzda, adlandırılmış alan oluşturmak için Google Chat API'nin Space kaynağında create yönteminin nasıl kullanılacağı açıklanmaktadı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ç alan türü vardır:

  • Doğrudan mesajlar (DM'ler), iki kullanıcı veya bir kullanıcı ile bir Chat uygulaması arasındaki görüşmelerdir.
  • Grup sohbetleri, üç veya daha fazla kullanıcı ile Chat 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.

Adlandırılmış alan, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalışmalar yaptığı bir yerdir. Adlandırılmış alanlar Chat uygulamalarını içerebilir. Adlandırılmış alanlarda, yönetim ayarlarını ve açıklamaları uygulayabilen, kullanıcı ve uygulama ekleyip kaldırabilen alan yöneticileri gibi adsız grup görüşmelerinde ve doğrudan mesajlarda bulunmayan ek özellikler bulunur. Adlandırılmış alan oluşturulduktan sonra alanın tek üyesi kimliği doğrulanmış kullanıcıdır. Alanda başka kullanıcılar veya uygulamalar yer almaz, alanı oluşturan Chat uygulaması dahil değildir. Kullanıcı eklemek için Member kaynağındaki create yöntemini çağırarak alanda üyelik oluşturun. Bunu nasıl yapacağınızı öğrenmek için Üyelik oluşturma başlıklı makaleyi inceleyin.

Birden çok üyeli adlandırılmış alan (üç veya daha fazla kişi arasındaki adsız grup sohbeti, iki kişi arasındaki doğrudan mesaj görüşmesi veya bir kişi ile Chat API'yi çağıran Chat uygulaması) oluşturmak için alan oluşturun.

Ön koşullar

Python

  • Python 3.6 veya sonraki sürümler
  • pip paket yönetimi aracı

  • Python için en yeni Google istemci kitaplıkları. Bunları yüklemek veya güncellemek için komut satırı arayüzünüzde aşağıdaki komutu çalıştırın:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Google Chat API'nin etkinleştirildiği ve yapılandırıldığı bir Google Cloud projesi Adımlar için Google Chat uygulaması oluşturma başlıklı makaleyi inceleyin.

  • Chat uygulaması için yetkilendirme yapılandırıldı. Alan oluşturmak için chat.spaces.create veya chat.spaces yetkilendirme kapsamıyla kullanıcı kimlik doğrulaması gerekir.

Node.js

  • Node.js ve npm

  • Node.js için en yeni Google istemci kitaplıkları. Bunları yüklemek için komut satırı arayüzünüzde aşağıdaki komutu çalıştırın:

    npm install @google-cloud/local-auth @googleapis/chat
  • Google Chat API'nin etkinleştirildiği ve yapılandırıldığı bir Google Cloud projesi Adımlar için Google Chat uygulaması oluşturma başlıklı makaleyi inceleyin.

  • Chat uygulaması için yetkilendirme yapılandırıldı. Alan oluşturmak için chat.spaces.create veya chat.spaces yetkilendirme kapsamıyla kullanıcı kimlik doğrulaması gerekir.

Adlandırılmış alan oluşturma

Adlandırılmış alan oluşturmak için isteğinizde aşağıdakileri iletin:

  • chat.spaces.create veya chat.spaces yetkilendirme kapsamını belirtin.
  • Space kaynağında create yöntemini çağırın.
  • spaceType değerini SPACE olarak ayarlayın.
  • displayName alanını, kullanıcının görebildiği alan adına ayarlayın. Aşağıdaki örnekte displayName, API-made olarak ayarlanmıştır.
  • İsteğe bağlı olarak spaceDetails gibi diğer alan özelliklerini (kullanıcının görebileceği bir açıklama ve alan için bir dizi yönerge) ayarlayın.

Adlandırılmış alan oluşturmak için aşağıdaki adımları uygulayın:

Python

  1. Çalışma dizininizde chat_space_create_named.py adlı bir dosya oluşturun.

  2. Aşağıdaki kodu chat_space_create_named.py bölümüne ekleyin:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.spaces.create"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then creates a Chat space.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                      'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds)

    # Use the service endpoint to call Chat API.
    result = chat.spaces().create(

      # Details about the space to create.
      body = {

        # To create a named space, set spaceType to SPACE.
        'spaceType': 'SPACE',

        # The user-visible name of the space.
        'displayName': 'API-made'
      }

      ).execute()

    # Prints details about the created space.
    print(result)

if __name__ == '__main__':
    main()

  3. Çalışma dizininizde örneği derleyin ve çalıştırın:

    python3 chat_space_create_named.py

Node.js

  1. Çalışma dizininizde create-space.js adlı bir dosya oluşturun.

  2. Aşağıdaki kodu create-space.js bölümüne ekleyin:

    const chat = require('@googleapis/chat');
const {authenticate} = require('@google-cloud/local-auth');

/**
* Creates a new chat space.
* @return {!Promise<!Object>}
*/
async function createSpace() {
  const scopes = [
    'https://www.googleapis.com/auth/chat.spaces.create',
  ];

  const authClient =
      await authenticate({scopes, keyfilePath: 'client_secrets.json'});

  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  return await chatClient.spaces.create(
      {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}});
}

createSpace().then(console.log);

  3. Çalışma dizininizde örneği çalıştırın:

    node create-space.js

Adlandırılmış bir alan oluşturulur. Alana gitmek için alanın kaynak kimliğini kullanarak alanın URL'sini oluşturun. name alanındaki kaynak kimliğini Google Chat yanıt gövdesinde bulabilirsiniz. Örneğin, alanınızın name değeri spaces/1234567 ise şu URL'yi kullanarak alana gidebilirsiniz: https://mail.google.com/chat/u/0/#chat/space/1234567.