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

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

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

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

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

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

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

Node.js

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

npm install @google-apps/chat

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

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

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

Python

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

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

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

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

• ที่เก็บใน 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
• การเริ่มต้นใช้งานอย่างรวดเร็ว

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. ติดตั้งเครื่องมือจัดการทรัพยากร Composer หากจำเป็น
2. จากอินเทอร์เฟซบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้

composer require google/apps-chat

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

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

.NET

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

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

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

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

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

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

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

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. ติดตั้ง:

   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 คือการใช้ไลบรารีไคลเอ็นต์ระบบคลาวด์ที่รองรับอย่างเป็นทางการสำหรับภาษาที่ต้องการ เช่น Python, Java หรือ Node.js

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

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

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

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