Alan oluşturma

Bu kılavuzda, adlandırılmış alan oluşturmak için Google Chat API'nin Space kaynağındaki 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ışma yaptığı kalıcı yerlerdir.

Adlandırılmış alan, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalışma yaptığı yerdir. Adlandırılmış alanlar Chat uygulamaları içerebilir. Adlandırılmış alanlar, yönetici ayarları ile açıklamaları uygulayabilen, kullanıcı ve uygulama ekleyip kaldırabilen alan yöneticileri gibi adsız grup görüşmeleri ve doğrudan mesajlarda bulunmayan ek özellikler içerir. Adlandırılmış bir alan oluşturduktan sonra alanın tek üyesi kimliği doğrulanmış kullanıcıdır. Alan, diğer kişileri veya uygulamaları, alanı oluşturan Chat uygulamasını bile içermez. Kullanıcı eklemek için Member kaynağında 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 (üç veya daha fazla kişi arasındaki adsız bir grup sohbeti ya da iki kişi arasındaki doğrudan mesaj görüşmesi veya bir kişi ile Chat API'yi çağıran Chat uygulaması) adlandırılmış alan oluşturmak için bir 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-httplib2 google-auth-oauthlib oauth2client

  • Yayınlanmış bir Chat uygulaması. Chat uygulaması oluşturup yayınlamak 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 öğesini SPACE olarak ayarlayın.
  • displayName değerini alanın kullanıcı tarafından görülebilen 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 açıklama ve alanla ilgili kurallar grubu) ayarlayabilirsiniz.

Adlandırılmış alan oluşturmak için:

Python

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

  2. chat_space_create_named.py içine şu kodu ekleyin:

    import os.path

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

# 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 membership.
    print(result)

if __name__ == '__main__':
    main()

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

    python3 chat_space_create_named.py

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