Punya waktu 5 menit? Bantu kami meningkatkan kualitas dokumentasi developer Google Chat dengan mengisi survei singkat.

Halaman ini diterjemahkan oleh Cloud Translation API.

Mengautentikasi dan memberi otorisasi sebagai pengguna Google Chat

Panduan ini menjelaskan cara menggunakan OAuth 2.0 dengan kredensial Google pengguna untuk mengakses Chat API. Melakukan autentikasi dan memberikan otorisasi dengan kredensial pengguna memungkinkan aplikasi Chat mengakses data pengguna dan melakukan operasi atas nama pengguna terautentikasi. Dengan mengautentikasi nama pengguna, aplikasi memiliki izin yang sama dengan pengguna tersebut dan dapat melakukan tindakan seolah-olah dilakukan oleh pengguna tersebut.

Setelah mengautentikasi dan memberi otorisasi panggilan API dengan kredensial pengguna, aplikasi Chat dapat melakukan hal-hal berikut:

Membuat ruang Chat.
Menambahkan pengguna ke ruang Chat dan percakapan grup.
Menggunakan data pengguna di API Workspace lainnya, seperti berikut:
- Buat acara di Google Kalender.
- Log item di Google Spreadsheet.
- Kirim email dengan Gmail.

Saat aplikasi melakukan tindakan dengan autentikasi pengguna (seperti membuat ruang), Google Chat akan menampilkan pesan atribusi yang memberi tahu pengguna nama aplikasi yang melakukan tindakan untuk pengguna yang memberikan otorisasi.

Aplikasi Google Chat menyediakan ruang untuk pengguna. — **Gambar 1**. Pesan atribusi yang ditampilkan Google Chat saat aplikasi Chat membuat ruang atas nama pengguna.

Untuk mempelajari lebih lanjut kapan aplikasi Chat memerlukan autentikasi dan jenis autentikasi yang akan digunakan, lihat Jenis autentikasi yang diperlukan di ringkasan otorisasi dan autentikasi Chat API.

Jika Anda merupakan administrator domain, Anda dapat memberikan delegasi otoritas tingkat domain untuk mengizinkan akun layanan aplikasi mengakses data pengguna Anda tanpa mengharuskan setiap pengguna memberikan izin. Setelah mengonfigurasi delegasi di seluruh domain, akun layanan dapat meniru identitas akun pengguna. Meskipun akun layanan digunakan untuk autentikasi, delegasi seluruh domain meniru identitas pengguna sehingga dianggap sebagai autentikasi pengguna. Setiap fungsi yang memerlukan autentikasi pengguna, Anda dapat menggunakan delegasi seluruh domain.

Prasyarat

Untuk menjalankan contoh dalam panduan ini, Anda memerlukan prasyarat berikut:

Akun Google Workspace dengan akses ke Google Chat.
Project Google Cloud dengan Chat API yang diaktifkan dan dikonfigurasi. Untuk membuat project dan mengaktifkan API, lihat Membuat project dan mengaktifkan API.
Aplikasi Chat yang dikonfigurasi di halaman konfigurasi Chat API di Google Cloud Console. Untuk membuat dan mengonfigurasi aplikasi Chat, lihat Mem-build aplikasi Google Chat dengan Cloud Functions.

Selain itu, Anda memerlukan prasyarat khusus bahasa berikut:

Java

JDK 1.7 atau yang lebih tinggi
Alat pengelolaan paket Maven

Project Maven yang diinisialisasi. Untuk menginisialisasi project baru, jalankan perintah berikut di antarmuka command line Anda:

mvn archetype:generate -DgroupId=com.google.chat.app.authsample -DartifactId=auth-sample-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

Python

Python 3.6 atau yang lebih baru
Alat pengelolaan paket pip

Node.js

Node.js
Alat pengelolaan paket npm
Project Node.js yang diinisialisasi. Untuk menginisialisasi project baru, buat dan beralihlah ke folder baru, lalu jalankan perintah berikut di antarmuka command line Anda:
```
npm init
```

Apps Script

Project Apps Script yang terhubung ke project Google Cloud Anda. Untuk menginisialisasi project Apps Script, lihat panduan memulai aplikasi Chat Google Apps Script.

Langkah 1: Konfigurasikan layar izin OAuth, tentukan cakupan, dan daftarkan aplikasi Anda

Saat Anda menggunakan OAuth 2.0 untuk otorisasi, Google akan menampilkan layar izin kepada pengguna, termasuk ringkasan project Anda, kebijakannya, dan cakupan otorisasi yang diminta. Mengonfigurasi layar izin OAuth aplikasi Anda akan menentukan apa yang ditampilkan Google kepada pengguna dan peninjau aplikasi, serta mendaftarkan aplikasi agar dapat dipublikasikan nanti.

Semua aplikasi yang menggunakan OAuth 2.0 memerlukan konfigurasi layar izin, tetapi Anda hanya perlu mencantumkan cakupan untuk aplikasi yang digunakan oleh orang di luar organisasi Google Workspace Anda.

Di konsol Google Cloud, buka Menu > APIs & Services > Layar izin OAuth.

Buka layar izin OAuth
Pilih jenis pengguna untuk aplikasi Anda, lalu klik Create.
Isi formulir pendaftaran aplikasi, lalu klik Simpan dan Lanjutkan.
Klik Tambahkan atau Hapus Cakupan. Tambahkan dan verifikasi cakupan otorisasi yang diperlukan oleh aplikasi Anda, klik Update, lalu klik Simpan dan Lanjutkan.

Catatan: Untuk menjalankan contoh autentikasi dalam panduan ini, tambahkan https://www.googleapis.com/auth/chat.spaces.create.

Guna meninjau cakupan yang tersedia untuk Chat API, lihat Cakupan Chat API di ringkasan autentikasi.
Tinjau ringkasan pendaftaran aplikasi Anda. Klik Edit untuk membuat perubahan, atau klik Kembali ke Dasbor.

Langkah 2: Buat kredensial client ID OAuth di Konsol Google Cloud

Untuk mengautentikasi sebagai pengguna akhir dan mengakses data pengguna di aplikasi, Anda perlu membuat satu atau beberapa Client ID OAuth 2.0. Client ID digunakan untuk mengidentifikasi satu aplikasi ke server OAuth Google. Jika aplikasi Anda berjalan di beberapa platform, seperti Android, iOS, dan Web, Anda harus membuat client ID terpisah untuk setiap platform.

Membuat kredensial client ID OAuth

Pilih jenis aplikasi Anda untuk mendapatkan petunjuk spesifik tentang cara membuat client ID OAuth:

Aplikasi web

Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.
Buka Kredensial
Klik Buat Kredensial > Client ID OAuth.
Klik Jenis aplikasi > Aplikasi web.
Di kolom Name, ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di Konsol Google Cloud.
Tambahkan URI resmi yang terkait dengan aplikasi Anda:
- Aplikasi sisi klien (JavaScript)–Di bagian Asal JavaScript yang sah, klik Tambahkan URI. Kemudian, masukkan URI yang akan digunakan untuk permintaan browser. Atribut ini mengidentifikasi domain tempat aplikasi Anda dapat mengirimkan permintaan API ke server OAuth 2.0.
- Aplikasi sisi server (Java, Python, dan lainnya)–Di bagian URI pengalihan yang diotorisasi, klik Tambahkan URI. Kemudian, masukkan URI endpoint yang dapat dikirimi respons oleh server OAuth 2.0.
Klik Create. Layar yang dibuat klien OAuth akan muncul, menampilkan Client ID dan Rahasia klien baru Anda.
Catat Client-ID. Rahasia klien tidak digunakan untuk aplikasi Web.
Klik OK. Kredensial yang baru dibuat akan muncul di bagian Client ID OAuth 2.0.

Android

Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.
Buka Kredensial
Klik Buat Kredensial > Client ID OAuth.
Klik Jenis aplikasi > Android.
Di kolom "Nama", ketik nama untuk kredensial. Nama ini hanya ditampilkan di Konsol Google Cloud.
Di kolom "Nama paket", masukkan nama paket dari file AndroidManifest.xml Anda.
Di kolom "SHA-1 certificate sidik jari", masukkan sidik jari sertifikat SHA-1 yang dihasilkan.
Klik Create. Layar yang dibuat klien OAuth akan muncul, yang menampilkan Client ID baru Anda.
Klik OK. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

iOS

Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.
Buka Kredensial
Klik Buat Kredensial > Client ID OAuth.
Klik Jenis aplikasi > iOS.
Di kolom "Nama", ketik nama untuk kredensial. Nama ini hanya ditampilkan di Konsol Google Cloud.
Di kolom "ID Paket", masukkan ID paket seperti yang tercantum dalam file Info.plist aplikasi.
Opsional: Jika aplikasi Anda muncul di Apple App Store, masukkan ID App Store.
Opsional: Di kolom "Team ID", masukkan string 10 karakter unik yang dibuat oleh Apple dan ditetapkan ke tim Anda.
Klik Create. Layar yang dibuat klien OAuth akan muncul, menampilkan Client ID dan Rahasia klien baru Anda.
Klik OK. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

Aplikasi Chrome

Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.
Buka Kredensial
Klik Buat Kredensial > Client ID OAuth.
Klik Jenis aplikasi > Aplikasi Chrome.
Di kolom "Nama", ketik nama untuk kredensial. Nama ini hanya ditampilkan di Konsol Google Cloud.
Di kolom "ID Aplikasi", masukkan string ID unik berisi 32 karakter aplikasi Anda. Anda dapat menemukan nilai ID ini di URL Chrome Web Store aplikasi dan di Dasbor Developer Chrome Web Store.
Klik Create. Layar yang dibuat klien OAuth akan muncul, menampilkan Client ID dan Rahasia klien baru Anda.
Klik OK. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

Aplikasi desktop

Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.
Buka Kredensial
Klik Buat Kredensial > Client ID OAuth.
Klik Jenis aplikasi > Aplikasi desktop.
Di kolom Name, ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di Konsol Google Cloud.
Klik Create. Layar yang dibuat klien OAuth akan muncul, menampilkan Client ID dan Rahasia klien baru Anda.
Klik OK. Kredensial yang baru dibuat akan muncul di bagian Client ID OAuth 2.0.

TV & Perangkat Input Terbatas

Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.
Buka Kredensial
Klik Buat Kredensial > Client ID OAuth.
Klik Jenis aplikasi > TV & Perangkat input Terbatas.
Di kolom "Nama", ketik nama untuk kredensial. Nama ini hanya ditampilkan di Konsol Google Cloud.
Klik Create. Layar yang dibuat klien OAuth akan muncul, menampilkan Client ID dan Rahasia klien baru Anda.
Klik OK. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

Universal Windows Platform (UWP)

Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.
Buka Kredensial
Klik Buat Kredensial > Client ID OAuth.
Klik Jenis aplikasi > Universal Windows Platform (UWP).
Di kolom "Nama", ketik nama untuk kredensial. Nama ini hanya ditampilkan di Konsol Google Cloud.
Di kolom "ID Store", masukkan nilai ID Microsoft Store unik 12 karakter untuk aplikasi Anda. Anda dapat menemukan ID ini di URL Microsoft Store untuk aplikasi Anda dan di Pusat Partner.
Klik Create. Layar yang dibuat klien OAuth akan muncul, menampilkan Client ID dan Rahasia klien baru Anda.
Klik OK. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

Mendownload file JSON rahasia klien

File rahasia klien adalah representasi JSON dari kredensial client ID OAuth yang dapat direferensikan oleh aplikasi Chat Anda saat memberikan kredensial.

Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.

Buka Kredensial
Pada Client ID OAuth 2.0, klik client ID yang Anda buat.
Klik Download JSON.
Simpan file sebagai client_secrets.json.

Langkah 3: Instal library klien Google dan dependensi lainnya

Instal library klien Google dan dependensi lain yang diperlukan untuk project.

Java

Untuk menambahkan library klien Google dan dependensi lain yang diperlukan ke project Maven Anda, edit file pom.xml di direktori project Anda dan tambahkan dependensi berikut:

<dependencies>
  <!-- ... existing dependencies ... -->
  <dependency>
    <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-chat</artifactId>
    <version>v1-rev20230905-2.0.0</version>
  </dependency>
  <dependency>
    <groupId>com.google.auth</groupId>
    <artifactId>google-auth-library-oauth2-http</artifactId>
    <version>1.19.0</version>
  </dependency>
  <dependency>
    <groupId>com.google.oauth-client</groupId>
    <artifactId>google-oauth-client-jetty</artifactId>
    <version>1.34.1</version>
  </dependency>
  <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.10.1</version>
  </dependency>
</dependencies>

Python

Jika Anda belum menginstal library klien Google untuk Python, jalankan perintah berikut di antarmuka command line Anda:

pip3 install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib oauth2client

Node.js

Untuk menambahkan library klien Google dan dependensi lain yang diperlukan ke project Node.js Anda, beralihlah ke direktori project dan jalankan perintah berikut di antarmuka command line:

npm install "@googleapis/chat" open server-destroy

Apps Script

Library tambahan tidak diperlukan untuk menjalankan contoh ini di Apps Script.

Anda dapat menggunakan bahasa apa pun yang didukung oleh library klien kami.

Langkah 4: Tulis skrip yang memanggil Chat API

Memanggil API dengan otorisasi OAuth adalah proses multi-langkah. Di aplikasi web atau desktop, prosesnya biasanya sebagai berikut:

Aplikasi mengarahkan pengguna ke halaman otorisasi yang meminta akses ke data pengguna yang ditentukan oleh cakupan otorisasi. Aplikasi mengidentifikasi dirinya sendiri dengan kredensial client ID.
Pengguna meninjau izin yang diminta oleh aplikasi dan menyetujui permintaan tersebut.
Server autentikasi Google mengalihkan browser ke endpoint HTTP aplikasi bersama dengan kode otorisasi.
Aplikasi akan mengirimkan permintaan lain ke server otorisasi Google untuk menukar kode otorisasi dengan token akses.
Aplikasi menggunakan token akses untuk memanggil API atas nama pengguna.

Untuk mempelajari proses otorisasi OAuth lebih lanjut, lihat Menggunakan OAuth 2.0 untuk Mengakses Panduan Google API.

Contoh kode di Java, Python, dan Node.js berikut menggunakan library klien untuk menjalankan alur otorisasi OAuth. Otorisasi ini membuka server HTTP lokal untuk menerima kembali kode otorisasi dari server otorisasi, yang kemudian ditukarkan dengan token akses. Dalam contoh kode Apps Script, alur otorisasi ini sudah ditangani oleh Apps Script. Jadi, aplikasi cukup menggunakan ScriptApp.getOAuthToken() untuk mendapatkan token akses pengguna.

Setelah menyelesaikan alur autentikasi, skrip mengautentikasi dengan Chat API menggunakan token akses pengguna, kemudian membuat ruang.

Java

Di direktori project Anda, buka file src/main/java/com/google/chat/app/authsample/App.java.

Ganti konten di App.java dengan kode berikut:

package com.google.chat.app.authsample;

import com.google.api.client.auth.oauth2.Credential;
import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.client.util.store.FileDataStoreFactory;
import com.google.api.services.chat.v1.HangoutsChat;
import com.google.api.services.chat.v1.model.Space;

import java.io.InputStreamReader;
import java.util.Collection;
import java.util.Collections;

/**
 * Authenticates with Chat API via user credentials, then creates a Chat space.
 */
public class App {
    // Application OAuth credentials.
    private static final String KEYS_RESOURCE_URI = "/client_secrets.json";

    // Define your app's authorization scopes.
    private static final Collection<String> SCOPES =
        Collections.singleton("https://www.googleapis.com/auth/chat.spaces.create");

    // Directory to store user credentials.
    private static final java.io.File DATA_STORE_DIR =
        new java.io.File(System.getProperty("user.home"), ".store/auth-sample-app");

    // Global instance of the JSON factory.
    private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();

    // Global instance of the HTTP transport.
    private static HttpTransport httpTransport;

    // Global instance of the DataStoreFactory. The best practice is to make it a single
    // globally shared instance across your application.
    private static FileDataStoreFactory dataStoreFactory;

    public static void main( String[] args ) {
        try {
            // Run app.
            httpTransport = GoogleNetHttpTransport.newTrustedTransport();
            dataStoreFactory = new FileDataStoreFactory(DATA_STORE_DIR);
            Credential userCredential = authorize();
            Space response = App.createChatSpace(userCredential);
            // Print details about the created space.
            System.out.println(response);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    /**
     * Authorizes the installed application to access user's protected data.
     */
    private static Credential authorize() throws Exception {
        // Load client secrets.
        GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(JSON_FACTORY,
            new InputStreamReader(App.class.getResourceAsStream("/client_secrets.json")));
        // Set up authorization code flow.
        GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder(
            httpTransport, JSON_FACTORY, clientSecrets, SCOPES)
            .setDataStoreFactory(dataStoreFactory)
            .build();
        // Authorize.
        return new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");
    }

    /**
     * Creates a Chat space.
     */
    private static Space createChatSpace(Credential userCredential) throws Exception {
        // Build the Chat API client and authenticate with the user account.
        HangoutsChat chatService = new HangoutsChat.Builder(
            httpTransport, JSON_FACTORY, userCredential)
            .setApplicationName("auth-sample-app")
            .build();

        // Create a Chat space.
        Space space = new Space()
            // To create a named space, set spaceType to SPACE.
            .setSpaceType("SPACE")
            // The user-visible name of the space.
            .setDisplayName("API-made");
        return chatService.spaces().create(space).execute();
    }
}

Buat subdirektori baru bernama resources dalam direktori project Anda.
Salin file client_secrets.json ke subdirektori resources.
Untuk mengonfigurasi Maven agar menyertakan file rahasia klien dalam paket project, edit file pom.xml di direktori project Anda dan tambahkan konfigurasi berikut ke bagian <build>:
```
<build>
  
  <resources>
    <resource>
      <directory>resources</directory>
    </resource>
  </resources>
</build>
```

Untuk mengonfigurasi Maven agar menyertakan dependensi dalam paket project dan menjalankan class utama aplikasi Anda, edit file pom.xml di direktori project dan tambahkan konfigurasi berikut ke bagian <plugins>:

<plugins>
  <!-- ... existing configurations ... -->
  <plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <configuration>
      <archive>
        <manifest>
          <mainClass>com.google.chat.app.authsample.App</mainClass>
        </manifest>
      </archive>
      <descriptorRefs>
        <descriptorRef>jar-with-dependencies</descriptorRef>
      </descriptorRefs>
    </configuration>
  </plugin>
</plugins>

Python

Simpan kode berikut dalam file bernama chat_space_create_named.py di direktori yang sama yang menyimpan client_secrets.json:

from __future__ import print_function

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

  flow = InstalledAppFlow.from_client_secrets_file(
                    'client_secrets.json', SCOPES)
  creds = flow.run_local_server()

  # Build a service endpoint for Chat API.
  service = build('chat', 'v1', credentials=creds)

  # Use the service endpoint to call Chat API.
  result = service.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()

Node.js

Simpan kode berikut dalam file bernama chat_space_create_named.js di direktori yang sama yang menyimpan project Node.js dan client_secrets.json:

const fs = require('fs');
const path = require('path');
const http = require('http');
const url = require('url');
const destroyer = require('server-destroy');

const chat = require('@googleapis/chat');

// Application OAuth credentials.
const keys = require('./client_secrets.json').installed;

// Define your app's authorization scopes.
// When modifying these scopes, delete the file token.json, if it exists.
const scopes = ["https://www.googleapis.com/auth/chat.spaces.create"];

// Create a new OAuth2 client with the configured keys.
const oauth2Client = new chat.auth.OAuth2(
  keys.client_id,
  keys.client_secret,
  'http://localhost:3000'
);

/**
 * Opens an HTTP server to accept the OAuth callback.
 * In this simple example, the only request to our webserver is to /?code=<code>.
 */
async function authenticate(scopes) {
  const opn = (await import('open')).default;

  return new Promise((resolve, reject) => {
    // Generate the URL for authorization.
    const authorizeUrl = oauth2Client.generateAuthUrl({
      access_type: 'offline',
      scope: scopes.join(' '),
    });
    // Start the HTTP server to listen for the callback.
    const server = http
      .createServer(async (req, res) => {
        try {
          const qs = new url.URL(req.url, 'http://localhost:3000').searchParams;
          res.end('Authentication successful! Please return to the console.');
          server.destroy();
          const { tokens } = await oauth2Client.getToken(qs.get('code'));
          oauth2Client.credentials = tokens;
          resolve(oauth2Client);
        } catch (e) {
          reject(e);
        }
      })
      .listen(3000, () => {
        // Open the browser to the authorize URL to start the workflow.
        opn(authorizeUrl, { wait: false }).then(cp => cp.unref());
      });
    destroyer(server);
  });
}

/**
 * Authenticates with Chat API via user credentials, then creates a Chat space.
 */
async function createSpace() {
  // Create the Chat API client and authenticate with the authorized user.
  const chatClient = await chat.chat({
    version: 'v1',
    auth: oauth2Client
  });

  // Call the Chat API to create a space.
  const result = await chatClient.spaces.create({

    // Details about the space to create.
    requestBody: {

      // To create a named space, set spaceType to SPACE.
      'spaceType': 'SPACE',

      // The user-visible name of the space.
      'displayName': 'API-made'

    }

  });
  return result;
}

// Authenticate the user, execute the function,
// then print details about the created space.
authenticate(scopes)
  .then(createSpace)
  .then(console.log);

Apps Script

Di editor Apps Script, edit file appsscript.json dan tambahkan cakupan OAuth yang diperlukan untuk memanggil API:

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.spaces.create",
    "https://www.googleapis.com/auth/script.external_request"
  ]

Simpan kode berikut dalam file bernama ChatSpaceCreateNamed.gs di project Apps Script Anda:

/**
 * Authenticates with Chat API via user credentials, then creates a Chat space.
 */
function createSpace() {
  // Call the Chat API to create a space.
  const result = UrlFetchApp.fetch('https://chat.googleapis.com/v1/spaces',
    {
      method: 'post',
      contentType: 'application/json',
      // Authenticate with the credentials of the user running the script.
      headers: { 'Authorization': 'Bearer ' + ScriptApp.getOAuthToken() },
      // Details about the space to create.
      payload: JSON.stringify({
        // To create a named space, set spaceType to SPACE.
        'spaceType': 'SPACE',
        // The user-visible name of the space.
        'displayName': 'API-made'
      })
    });

  // Log details about the created space.
  console.log(result.getContentText());
}

Langkah 5: Jalankan skrip contoh

Untuk menjalankan contoh, dari command line, buka direktori yang menyimpan file project Anda, lalu jalankan perintah berikut:

Java

mvn compile assembly:single
java -jar target/auth-sample-app-1.0-SNAPSHOT-jar-with-dependencies.jar

Python

python3 chat_space_create_named.py

Node.js

node chat_space_create_named.js

Apps Script

Buka file ChatSpaceCreateNamed.gs di Apps Script Editor, lalu klik Run.

Browser akan terbuka dan meminta Anda login ke Akun Google Anda:

Gambar 2. Layar izin OAuth tempat Anda memilih akun untuk mengautentikasi aplikasi.

Setelah login, layar izin OAuth akan muncul dan meminta Anda untuk memberikan izin ke aplikasi.

Setelah Anda memberikan izin, skrip akan memanggil Chat API, yang merespons dengan membuat ruang Chat dengan nama tampilan API-made. Konsol akan mencetak detail panggilan API. Untuk menemukan ruang, buka panel Ruang di Google Chat.

Memecahkan masalah contoh

Saat menjalankan chat_space_create_named.py, Anda mungkin menerima error yang bertuliskan:

Expected a JSON object with a single property for a "web" or "installed" application

Pesan error ini berarti bahwa file client_secrets.json yang Anda download dari Google Cloud Console tidak diawali dengan properti "web" atau "installed". Setelah mengautentikasi dengan file yang didownload, jika kode Anda tidak menyimpan token akses di file baru seperti token.json, token akses akan ditulis ke client_secrets.json, yang dapat menyebabkan error ini pada upaya otorisasi berikutnya.

Untuk mengatasi error ini, download lagi file rahasia klien dari konsol Google Cloud, lalu simpan file baru tersebut di tempat file saat ini.

Jika aplikasi Anda perlu terus menggunakan token pengguna di luar cakupan alur tunggal, aplikasi tersebut dapat menyimpan token tersebut untuk digunakan kembali nanti. Dalam hal ini, aplikasi Anda harus menangani token pengguna dengan aman dan menangani pencabutan dan akhir masa berlaku token refresh. Untuk informasi selengkapnya, lihat Panduan Praktik Terbaik OAuth 2.0.
Pelajari hal lain yang dapat dilakukan Chat API dengan meninjau dokumentasi referensi Chat API.

Mengautentikasi dan memberi otorisasi sebagai pengguna Google Chat

Prasyarat

Java

Python

Node.js

Apps Script

Langkah 1: Konfigurasikan layar izin OAuth, tentukan cakupan, dan daftarkan aplikasi Anda

Langkah 2: Buat kredensial client ID OAuth di Konsol Google Cloud

Membuat kredensial client ID OAuth

Aplikasi web

Android

iOS

Aplikasi Chrome

Aplikasi desktop

TV & Perangkat Input Terbatas

Universal Windows Platform (UWP)

Mendownload file JSON rahasia klien

Langkah 3: Instal library klien Google dan dependensi lainnya

Java

Python

Node.js

Apps Script

Langkah 4: Tulis skrip yang memanggil Chat API

Java

Python

Node.js

Apps Script

Langkah 5: Jalankan skrip contoh

Java

Python

Node.js

Apps Script

Memecahkan masalah contoh

Topik terkait