Crea uno spazio

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

La risorsa Space 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 spazi permanenti in cui le persone inviano messaggi, condividono file e collaborano.

Uno spazio denominato è un luogo in cui le persone inviano messaggi, condividono file e collaborano. Gli spazi con nome possono includere app di chat. Gli spazi con nome includono funzionalità aggiuntive che non sono disponibili nelle conversazioni di gruppo e nei messaggi diretti senza nome, ad esempio i 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 include altre persone o app, neanche l'app Chat che lo crea. Per aggiungere persone, crea appartenenze allo spazio chiamando il metodo create nella risorsa Member. Per scoprire come fare, vedi Creare un abbonamento.

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

Prerequisiti

Python

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

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

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Un progetto Google Cloud in cui l'API Google Chat è abilitata e configurata. Per i passaggi da seguire, consulta Creare un'app Google Chat.

  • Autorizzazione configurata per l'app di Chat. La creazione di uno spazio richiede l'autenticazione utente con l'ambito di autorizzazione chat.spaces.create o chat.spaces.

Node.js

  • Node.js e npm

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

    npm install @google-cloud/local-auth @googleapis/chat
  • Un progetto Google Cloud in cui l'API Google Chat è abilitata e configurata. Per i passaggi da seguire, consulta Creare un'app Google Chat.

  • Autorizzazione configurata per l'app di Chat. La creazione di uno spazio richiede l'autenticazione utente con l'ambito di autorizzazione chat.spaces.create o chat.spaces.

Creare uno spazio con nome

Per creare uno spazio con nome, trasmetti quanto segue nella richiesta:

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

Ecco come creare uno spazio con nome:

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

    node create-space.js

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