İlk üyelerin bulunduğu bir alan oluşturma

Bu kılavuzda, setup yönteminin Space kaynağında nasıl kullanılacağı açıklanmaktadır. Google Chat API'ye gidin. Alan oluşturulduğunda alan oluşturulur ve belirtilen kullanıcıları buna ekler.

İ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.

Alan oluştururken aşağıdakileri göz önünde bulundurun:

  • Arayan (kimliği doğrulanmış) kullanıcı, alana otomatik olarak eklenir. Böylece istekte kullanıcının üyeliğini belirtmeniz gerekmez.
  • Doğrudan mesaj (DM) oluştururken, iki kullanıcı arasında bir doğrudan mesaj varsa DM döndürülür. Aksi takdirde bir DM oluşturulur.
  • Grup sohbeti oluştururken istekte üyeliklerden hiçbiri sağlanmamışsa başarıyla eklenmişse (örneğin, izin sorunu), ardından boş bir grup sohbeti (yalnızca arayan kullanıcı dahil) oluşturulabilir.
  • Mesaj dizili yanıtlar içeren alanlar oluşturamaz veya hesabınızın dışındaki kullanıcıları ekleyemezsiniz Google Workspace
  • İstekte yinelenen üyelikler (arayan kullanıcı dahil) sağlanmış filtrelendiğinden emin olun.

Ön koşullar

Python

  • Python 3.6 veya sonraki sürümler
  • pip paket yönetim aracı
  • En yeni Google istemci kitaplıkları. Bu uygulamaları 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

Node.js

  • Node.js 14 veya sonraki sürümler
  • npm paket yönetim aracı
  • En yeni Google istemci kitaplıkları. Bu uygulamaları yüklemek veya güncellemek 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

Alan oluşturma

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: setup yöntem Space kaynağında.
  • Bir gerçek kullanıcıyı alan üyesi olarak eklemek için users/{user} değerini belirtin. Burada {user} öğe için {person_id} person People API'den veya bir kullanıcının user bulun. Örneğin, People API resourceName people/123456789. Kullanıcıyı alana ekleyebilirsiniz: member.name olarak users/123456789 üyeliği de buna dahildir.
  • Bir grubu alan üyesi olarak eklemek için groups/{group} değerini belirtin. Burada {group} kelimesi kullanılır. üyelik oluşturmak istediğiniz grup kimliğini girin. Grubun kimliği şunları yapabilir: Cloud Identity API kullanılarak alınabilir. Örneğin, Cloud Identity API groups/123456789 adlı bir grup döndürür, ardından membership.groupMember.name - groups/123456789. Google Grupları, ancak yalnızca adlandırılmış bir alana eklenmiş olması gerekir.
  • Arayan kullanıcı ile başka bir kişi arasında DM oluşturmak için kullanıcı olarak, isteğinizde gerçek kullanıcının üyeliğini belirtin.
  • Arayan kullanıcı ile arama uygulaması arasında DM oluşturmak için Space.singleUserBotDm tarafından true ile paylaşıldı ve üyelik belirtmeyin. Şunları yapabilirsiniz: bu yöntemi yalnızca arama uygulamasıyla bir DM ayarlamak için kullanın. Görüşmeyi eklemek için veya iki kullanıcı arasındaki mevcut bir DM'nin üyesi olarak uygulamayı görmek için üyelik oluşturabilirsiniz.

Aşağıdaki örnekte, adlandırılmış bir alan ve alana üyelikler oluşturuluyor bir grup ve üç gerçek kullanıcı (kimliği doğrulanmış kullanıcı ve belirtilen diğer kullanıcılar).

Python

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

  2. Aşağıdaki kodu chat_space_setup.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 sets up a Chat space by creating a space and adding members.
    '''

    # 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().setup(

      # Details about the space to set up.
      body = {

        # Attributes of the space to set up, like space type and display name.
        'space': {

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

            # The user-visible name of the space
            'displayName': 'API-setup'
        },

        # The users and groups to add to the space.
        #
        # The authenticated user is automatically added to the space,
        # and doesn't need to be specified in the memberships array.
        'memberships': [
            {
              'member': {
                'name':'users/123456789',
                'type': 'HUMAN'
              }
            },
            {
              'member': {
                'name':'users/987654321',
                'type': 'HUMAN'
              }
            },
            {
              'groupMember': {
                'name': 'groups/11223344'
              }
            }
        ]
      }

      ).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_setup.py

Node.js

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

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

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

/**
* Sets up a new Chat space with users.
* @return {!Promise<!Object>}
*/
async function setupSpace() {
  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.setup({
    requestBody: {
      space: {
        spaceType: 'SPACE',
        displayName: 'API-made',
      },
      memberships: [
        {member: {name: 'users/123456789', type: 'HUMAN'}},
        {member: {name: 'users/987654321', type: 'HUMAN'}},
        {groupMember: {name: 'groups/11223344'}},
      ]
    }
  });
}

setupSpace().then(console.log);

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

    node setup-space.js

Bir grup ve üç gerçek kullanıcının bulunduğu, adlandırılmış sohbet alanı ayarlanmış olduğundan emin olun.

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