ไลบรารีของไคลเอ็นต์ Google Chat API

ไลบรารีของไคลเอ็นต์ช่วยเพิ่มประสิทธิภาพให้กับประสบการณ์การใช้งานสำหรับนักพัฒนาแอปในการเรียกใช้ Google Chat API ด้วยการลดโค้ดสำเร็จรูปที่คุณต้องเขียน คู่มือนี้จะแนะนำ ไลบรารีของไคลเอ็นต์ และอธิบายวิธีติดตั้ง

Chat API มี gRPC และ พัก อินเทอร์เฟซ และ ไลบรารีของไคลเอ็นต์ที่รองรับทั้ง 2 ประเภท ไลบรารีไคลเอ็นต์ Cloud รองรับ gRPC และ REST ไลบรารีของไคลเอ็นต์ Google API รองรับเฉพาะอินเทอร์เฟซ REST เท่านั้น แต่คุณจะ ใช้ไลบรารีของไคลเอ็นต์ทั้ง 2 รายการในโปรเจ็กต์เดียวกันได้ (ไม่บังคับ) หาก ไลบรารีของไคลเอ็นต์ที่จัดเตรียมไว้ให้ไม่ตรงกับความต้องการของคุณ คุณสามารถเขียนไลบรารี ไลบรารีของไคลเอ็นต์ที่ใช้อินเทอร์เฟซ gRPC หรือ REST

หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับ ประเภทไลบรารีของไคลเอ็นต์ที่ Google รองรับ โปรดดู คำอธิบายไลบรารีของไคลเอ็นต์

ติดตั้งไลบรารีไคลเอ็นต์ Cloud (แนะนำ)

ไลบรารีไคลเอ็นต์ Cloud คือไลบรารีของไคลเอ็นต์ล่าสุดและแนะนำสำหรับการเรียกใช้ Chat API ไลบรารีไคลเอ็นต์ Cloud รองรับทั้ง gRPC และ REST อินเทอร์เฟซ

Chat API มีไลบรารีไคลเอ็นต์ระบบคลาวด์สำหรับภาษาต่อไปนี้ เลือกภาษาที่ต้องการใช้

Node.js

วิธีติดตั้งไลบรารีของไคลเอ็นต์

npm install @google-apps/chat

ลองดูตัวอย่างไลบรารีของไคลเอ็นต์ระบบคลาวด์สำหรับ Node.js

ดูข้อมูลเพิ่มเติม

• ที่เก็บของ GitHub
• ข้อมูลอ้างอิงของไลบรารีของไคลเอ็นต์ Cloud
• คู่มือเริ่มต้นฉบับย่อ

Java

เลือกสภาพแวดล้อมของบิลด์จากแท็บต่อไปนี้ ไม่ว่าคุณจะ อย่าลืมอัปเดตเวอร์ชัน เป็นรุ่นล่าสุดที่มีให้ใช้งาน GitHub

Maven กับ BOM

หากคุณใช้ Maven กับ BOM เพิ่มรายการนี้ลงในไฟล์ pom.xml ของคุณ:

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>libraries-bom</artifactId>
        <version>26.42.0</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>google-cloud-chat</artifactId>
    </dependency>

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-chat</artifactId>
  <version>0.10.0</version>
</dependency>

Maven ที่ไม่มี BOM

หากคุณใช้ Maven โดยไม่มี BOM เพิ่มรายการนี้ลงในทรัพยากร Dependency ของคุณ:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-chat</artifactId>
  <version>0.9.0</version>
</dependency>

Gradle

หากใช้ Gradle โดยไม่มี BOM เพิ่มรายการนี้ลงในทรัพยากร Dependency ของคุณ:

implementation 'com.google.cloud:google-cloud-chat:0.10.0'

SBT

หากคุณใช้ SBT ให้เพิ่มค่านี้ลงในทรัพยากร Dependency ด้วย

libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"

ลองดูตัวอย่างไลบรารีของไคลเอ็นต์ระบบคลาวด์สำหรับ Java

ดูข้อมูลเพิ่มเติม

• ที่เก็บของ GitHub
• ข้อมูลอ้างอิงของไลบรารีของไคลเอ็นต์ Cloud
• คู่มือเริ่มต้นฉบับย่อ

Python

ใน Mac หรือ Linux ให้เรียกใช้คำสั่งต่อไปนี้จากอินเทอร์เฟซบรรทัดคำสั่ง

python3 -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat

บน Windows ให้เรียกใช้คำสั่งต่อไปนี้จากอินเทอร์เฟซบรรทัดคำสั่ง

py -m venv <your-env>
.\<your-env>\Scripts\activate
pip install google-apps-chat

ลองดูตัวอย่างไลบรารีของไคลเอ็นต์ระบบคลาวด์สำหรับ Python

ดูข้อมูลเพิ่มเติม

• ที่เก็บของ GitHub
• ข้อมูลอ้างอิงของไลบรารีของไคลเอ็นต์ Cloud
• คู่มือเริ่มต้นฉบับย่อ

Go

นำเข้าแพ็กเกจ Go สำหรับบริการของ Google Cloud

import "cloud.google.com/go"

วิธีติดตั้งแพ็กเกจในระบบของคุณ

1. เปลี่ยนเป็นไดเรกทอรีโปรเจ็กต์: cd /my/cloud/project
2. ดาวน์โหลดแพ็กเกจที่ต้องการใช้

go get cloud.google.com/go/chat

ดูข้อมูลเพิ่มเติม

• ที่เก็บของ GitHub
• ข้อมูลอ้างอิงของไลบรารีของไคลเอ็นต์ Cloud

Ruby

วิธีติดตั้งไลบรารีของไคลเอ็นต์

gem install google-apps-chat

ดูข้อมูลเพิ่มเติม

• ที่เก็บของ GitHub
• ข้อมูลอ้างอิงของไลบรารีของไคลเอ็นต์ Cloud

PHP

วิธีติดตั้งไลบรารีของไคลเอ็นต์

1. หากจำเป็น ให้ติดตั้ง Dependency Manager คอมโพสเซอร์
2. จากอินเทอร์เฟซของบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้

composer require google/apps-chat

ดูข้อมูลเพิ่มเติม

• ที่เก็บของ GitHub
• ข้อมูลอ้างอิงของไลบรารีของไคลเอ็นต์ Cloud

.NET

วิธีติดตั้งไลบรารีของไคลเอ็นต์

ติดตั้งแพ็กเกจ Google.Apps.Chat.V1 จาก NuGet เพิ่มลงใน ในลักษณะปกติ (เช่น คลิกขวาที่โปรเจ็กต์ใน Visual Studio และเลือก "จัดการแพ็กเกจ NuGet...") โปรด เปิดใช้แพ็กเกจก่อนเผยแพร่ (เช่น ใน Visual Studio NuGet ของผู้ใช้ แล้วทำเครื่องหมายที่ช่อง "รวมรุ่นทดลอง" )

หากต้องการติดตั้งแพ็กเกจ NuGet โปรดไปที่ Google.Apis ที่ NuGet.org

ดูข้อมูลเพิ่มเติม

• ที่เก็บของ GitHub
• ข้อมูลอ้างอิงของไลบรารีของไคลเอ็นต์ Cloud

ติดตั้งไลบรารีของไคลเอ็นต์ Google API

อีกหนึ่งทางเลือกที่จะใช้แทนไลบรารีของไคลเอ็นต์ระบบคลาวด์ ไลบรารีของไคลเอ็นต์ Google API ให้สิทธิ์เข้าถึง Chat API แบบเป็นโปรแกรมโดยใช้ทรัพยากร REST และ คุณอาจต้องการใช้ ไลบรารีของไคลเอ็นต์ Google API หากคุณใช้ภาษาที่ไม่มี ไลบรารีของไคลเอ็นต์ระบบคลาวด์ หรือหากคุณกำลังขยายโปรเจ็กต์ที่ใช้ไลบรารีอยู่แล้ว

Chat API มีไลบรารีของไคลเอ็นต์ Google API สำหรับสิ่งต่อไปนี้ ภาษา เลือกภาษาที่ต้องการใช้

Go

ดูไลบรารีของไคลเอ็นต์ Google Chat API ล่าสุดสำหรับ Go (อัลฟ่า) อ่านคู่มือสำหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์

Java

หน้านี้มีข้อมูลเกี่ยวกับการเริ่มต้นใช้งาน Google Chat API โดยใช้ ไลบรารีของไคลเอ็นต์ Google API สำหรับ Java สําหรับข้อมูลเพิ่มเติม โปรดดูเอกสารประกอบต่อไปนี้

• เรียกดูเอกสารอ้างอิง Javadoc สําหรับ Google Chat API
• อ่านคู่มือสำหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์ Google API สำหรับ Java

เพิ่มไลบรารีของไคลเอ็นต์ลงในโปรเจ็กต์

เลือกสภาพแวดล้อมของบิลด์ (Maven หรือ Gradle) จากแท็บต่อไปนี้

Maven

เพิ่มโค้ดต่อไปนี้ในไฟล์ pom.xml

ดูทุกเวอร์ชันที่มีให้บริการในที่เก็บส่วนกลางของ Maven

Gradle

เพิ่มโค้ดต่อไปนี้ในไฟล์ build.gradle

ดูทุกเวอร์ชันที่มีให้บริการในที่เก็บส่วนกลางของ Maven

JavaScript

อ่านคู่มือสำหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์

.NET

หน้านี้มีข้อมูลเกี่ยวกับการเริ่มต้นใช้งาน Google Chat API โดยใช้ ไลบรารีของไคลเอ็นต์ Google API สำหรับ .NET สำหรับข้อมูลเพิ่มเติม โปรดดูเอกสารประกอบต่อไปนี้

• เรียกดูเอกสารประกอบข้อมูลอ้างอิงของ .NET สำหรับ Google Chat API
• อ่านคู่มือสำหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์ Google API สำหรับ .NET

การดาวน์โหลดไลบรารี

ติดตั้งแพ็กเกจ NuGet นี้ Google.Apis

Node.js

ดูไลบรารีของไคลเอ็นต์ Google Chat API ล่าสุดสำหรับ Node.js อ่านคู่มือสำหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์

Obj-C

ดูไลบรารีของไคลเอ็นต์ Google Chat API ล่าสุดสำหรับ Objective-C อ่านคู่มือสำหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์

PHP

ดูไลบรารีของไคลเอ็นต์ Google Chat API ล่าสุดสำหรับ PHP อ่านคู่มือสำหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์

Python

หน้านี้มีข้อมูลเกี่ยวกับการเริ่มต้นใช้งาน Google Chat API โดยใช้ ไลบรารีของไคลเอ็นต์ Google API สำหรับ Python สําหรับข้อมูลเพิ่มเติม โปรดดูเอกสารประกอบต่อไปนี้

• เรียกดูข้อมูลอ้างอิงของ PyDoc สำหรับ Google Chat API
• อ่านคู่มือสำหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์ Google API สำหรับ Python

ข้อกำหนดของระบบ

• ระบบปฏิบัติการ:
  • Linux
  • macOS X
  • Windows
• Python 2.7 หรือ 3.4 ขึ้นไป

ติดตั้งไลบรารีของไคลเอ็นต์

คุณจะใช้ตัวจัดการแพ็กเกจหรือดาวน์โหลดและติดตั้งไลบรารีของไคลเอ็นต์ Python ด้วยตนเองก็ได้โดยทำดังนี้

การติดตั้งที่มีการจัดการ

ใช้ pip หรือ setuptools เพื่อจัดการการติดตั้ง (คุณอาจต้องเรียกใช้ sudo ก่อน) ดังนี้

• pip (แนะนำ):

  pip install --upgrade google-api-python-client

• Setuptools:

  easy_install --upgrade google-api-python-client

ติดตั้งด้วยตัวเอง

1. ดาวน์โหลดไลบรารีของไคลเอ็นต์ล่าสุดสำหรับ Python
2. คลายการแพคข้อมูลรหัส
3. Install:

   python setup.py install

App Engine

เนื่องจากไม่มีการติดตั้งไลบรารีของไคลเอ็นต์ Python ในสภาพแวดล้อมรันไทม์ของ Python สําหรับ App Engine คุณจึงต้องคัดลอกไลบรารีเหล่านี้ลงในแอปพลิเคชันเช่นเดียวกับไลบรารีของบุคคลที่สาม

Ruby

หน้านี้มีข้อมูลเกี่ยวกับการเริ่มต้นใช้งาน Google Chat API โดยใช้ ไลบรารีของไคลเอ็นต์ Google API สำหรับ Ruby สําหรับข้อมูลเพิ่มเติม โปรดดูเอกสารประกอบต่อไปนี้

• อ่านคู่มือเริ่มต้นใช้งานไลบรารีของไคลเอ็นต์ Google API สำหรับ Ruby

ติดตั้ง Gem google-api-client

อาจต้องเพิ่ม sudo ไว้หน้าคำสั่งเหล่านี้ ทั้งนี้ขึ้นอยู่กับระบบของคุณ

หากคุณยังไม่เคยติดตั้งไลบรารีของไคลเอ็นต์ Google API สำหรับ Ruby มาก่อน ให้ติดตั้งโดยใช้ RubyGems ดังนี้

gem install google-api-client

หากติดตั้ง Gem แล้ว ให้อัปเดตเป็นเวอร์ชันล่าสุด

gem update -y google-api-client

การเริ่มต้นใช้งานไลบรารีของไคลเอ็นต์ Google API สำหรับ Ruby

ดูวิธีส่งคำขอแรกได้ที่คู่มือเริ่มต้นใช้งาน

Apps Script และไลบรารีของไคลเอ็นต์

วิธีที่แนะนำสำหรับนักพัฒนาซอฟต์แวร์ส่วนใหญ่ในการเรียกใช้ Google Chat API คือการสนับสนุนอย่างเป็นทางการ ไลบรารีไคลเอ็นต์ Cloud สำหรับภาษาที่ต้องการ เช่น Python, Java หรือ Node.js

ถ้าคุณเขียนโค้ดด้วยสคริปต์ Google Apps ให้ใช้ บริการ Chat ขั้นสูง แทนการติดตั้งไลบรารีของไคลเอ็นต์

การตรวจสอบสิทธิ์

การเรียกใช้ Chat API ต้องมีการตรวจสอบสิทธิ์ ชิ้น เมธอด Chat API ต้องใช้วิธีใดวิธีหนึ่ง การตรวจสอบสิทธิ์ผู้ใช้ (เพื่อดำเนินการหรือเข้าถึง ข้อมูลในนามของผู้ใช้) หรือ การตรวจสอบสิทธิ์แอป (เพื่อดำเนินการต่างๆ หรือเข้าถึงข้อมูลในฐานะแอป Chat) ใช้บ้าง รองรับทั้งการตรวจสอบสิทธิ์ผู้ใช้และการตรวจสอบสิทธิ์แอป

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์ใน Chat ได้ที่ ภาพรวมการตรวจสอบสิทธิ์