Alan oluşturma

Bu kılavuzda, create yönteminin Space kaynağında nasıl kullanılacağı açıklanmaktadır. Google Chat API'yi kullanarak adlandırılmış alan oluşturun.

İlgili içeriği oluşturmak için kullanılan Space kaynak kullanıcıların ve Chat uygulamalarının mesaj gönderebildiği, dosya paylaşabilir ve ortak çalışabilirsiniz. Birkaç alan türü vardır:

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

Adlandırılmış alan, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve yardımcı olmaktır. Adlandırılmış alanlar Chat uygulamalarını içerebilir. Adlandırılmış alanlar Adsız grup görüşmeleri ve doğrudan mesajlar içeren ek özellikler içerir bunlara sahip değildir (ör. yönetim ayarlarını uygulayabilen alan yöneticileri, açıklamaları, kişi ve uygulamaları ekleyip kaldırabilirsiniz. Adlandırılmış alan oluşturduktan sonra alanın tek üyesi, kimliği doğrulanmış kullanıcıdır. Alan diğer kullanıcıları veya uygulamaları dahil etme; Chat uygulamasını bile değil, adım adım açıklıyor. Kullanıcı eklemek için create yöntem uygulamasında Member kaynak. Bunu nasıl yapacağınızı öğrenmek için Üyelik oluşturma başlıklı makaleyi inceleyin.

Birden çok üye içeren adlandırılmış bir alan (arasında adsız bir grup sohbeti) oluşturmak için iki kişi arasındaki doğrudan mesaj görüşmesinin veya bir ve Chat uygulamasında Chat API: Alan oluşturma .

Ön koşullar

Python

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

  • Python için en yeni Google istemci kitaplıkları. 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 bkz. Google Chat uygulaması oluşturun.

  • Chat uygulaması için yetkilendirme yapılandırıldı. Oluşturuluyor bir alan Kullanıcı kimlik doğrulaması chat.spaces.create veya chat.spaces yetkilendirme kapsamı.

Node.js

  • Node.js ve npm

  • Node.js için en yeni Google istemci kitaplıkları. Bunları yüklemek için aşağıdaki komutu girin:

    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 bkz. Google Chat uygulaması oluşturun.

  • Chat uygulaması için yetkilendirme yapılandırıldı. Oluşturuluyor bir alan Kullanıcı kimlik doğrulaması chat.spaces.create veya chat.spaces yetkilendirme kapsamı.

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.
  • Şunu çağırın: create yöntem uygulamasında Space kaynak.
  • Ayarla spaceType Hedef: SPACE.
  • Ayarla displayName kullanıcının görebildiği alanın adına ekleyin. Aşağıdaki örnekte, displayName API-made olarak ayarlandı.
  • İsteğe bağlı olarak, spaceDetails (alan için kullanıcıların görebileceği bir açıklama ve bir dizi yönerge).

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 kullanın tıklayın. Kaynak kimliğini alanda bulabilirsiniz Google Chat yanıt gövdesinde name. Örneğin, alanınız name spaces/1234567. Aşağıdakileri kullanarak alana gidebilirsiniz URL: https://mail.google.com/chat/u/0/#chat/space/1234567.