Crea uno spazio

Questa guida spiega come utilizzare il metodo create nella risorsa Space di l'API Google Chat per creare uno spazio denominato.

La Space risorsa rappresenta un luogo in cui le persone e le app di chat possono inviare messaggi, condividere file e collaborare. Esistono diversi tipi di spazi:

  • I messaggi diretti sono conversazioni tra due utenti o un utente e un'app di Chat.
  • Le chat di gruppo sono conversazioni tra tre o più utenti e App di chat.
  • Gli spazi con nome sono luoghi permanenti in cui le persone inviano messaggi, condividono file e collaborare.

Uno spazio denominato è un luogo in cui le persone inviano messaggi, condividono file e collaborare. Gli spazi denominati possono includere app di chat. Spazi denominati Includono funzionalità aggiuntive che consentono di indirizzare i messaggi e le conversazioni di gruppo senza nome non disponibili, ad esempio gestori dello spazio che possono applicare impostazioni amministrative, descrizioni e aggiungere o rimuovere persone e app. Dopo aver creato uno spazio denominato, l'unico membro dello spazio è l'utente autenticato. Lo spazio non Includono altre persone o app; nemmeno l'app Chat che li crea. Per aggiungere persone, crea iscrizioni nello spazio chiamando il Metodo create il Member risorsa. Per scoprire come fare, vedi Creare un abbonamento.

Per creare uno spazio denominato con più membri, ovvero una chat di gruppo senza nome tra da tre o più persone oppure da una conversazione con messaggi diretti tra due persone oppure e l'app Chat che chiama API Chat: configura uno spazio .

Prerequisiti

Python

  • Python 3.6 o versioni successive
  • Il pip strumento di gestione dei pacchetti

  • Le librerie client di Google più recenti per Python. Per installare o aggiornare esegui questo comando nell'interfaccia a riga di comando:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Un progetto Google Cloud con l'API Google Chat abilitata e configurata. Per i passaggi, vedi Crea un'app Google Chat.

  • Autorizzazione configurata per l'app Chat. Creazione in corso... uno spazio richiede L'autenticazione degli utenti con Ambito dell'autorizzazione chat.spaces.create o chat.spaces.

Node.js

  • Node.js e

  • Le librerie client di Google più recenti per Node.js. Per installarle, esegui il seguente comando nell'interfaccia a riga di comando:

    npm install @google-cloud/local-auth @googleapis/chat
  • Un progetto Google Cloud con l'API Google Chat abilitata e configurata. Per i passaggi, vedi Crea un'app Google Chat.

  • Autorizzazione configurata per l'app Chat. Creazione in corso... uno spazio richiede L'autenticazione degli utenti con Ambito dell'autorizzazione chat.spaces.create o chat.spaces.

Crea uno spazio denominato

Per creare uno spazio denominato, trasmetti quanto segue nella richiesta:

  • Specifica l'ambito dell'autorizzazione chat.spaces.create o chat.spaces.
  • Chiama il Metodo create il Space risorsa.
  • Imposta spaceType a SPACE.
  • Imposta displayName al nome dello spazio visibile dall'utente. Nell'esempio seguente, displayName è impostato su API-made.
  • Se vuoi, puoi impostare altri attributi dello spazio, come spaceDetails (una descrizione visibile all'utente e una serie di linee guida per lo spazio).

Ecco come creare uno spazio denominato:

Python

  1. Nella directory di lavoro, crea un file denominato chat_space_create_named.py.

  2. Includi il seguente codice in chat_space_create_named.py:

    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. Nella directory di lavoro, crea ed esegui l'esempio:

    python3 chat_space_create_named.py

Node.js

  1. Nella directory di lavoro, crea un file denominato create-space.js.

  2. Includi il seguente codice in create-space.js:

    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. Nella directory di lavoro, esegui l'esempio:

    node create-space.js

Viene creato uno spazio denominato. Per accedere allo spazio, utilizza l'ID risorsa dello spazio per creare l'URL dello spazio. Puoi trovare l'ID risorsa nello spazio name nel corpo della risposta di Google Chat. Ad esempio, se il tuo spazio name è spaces/1234567, puoi accedere allo spazio utilizzando: URL: https://mail.google.com/chat/u/0/#chat/space/1234567.