ספריות הלקוח של Google Chat API

ספריות לקוח מבצעות אופטימיזציה של חוויית השימוש למפתחים לקריאה ל-Google Chat API על ידי צמצום הקוד הרגיל שצריך לכתוב. במדריך הזה נסביר ספריות הלקוח ומסבירות איך להתקין אותן.

ל-Chat API יש gRPC וגם REST ממשקים, ספריות לקוח שתומכות בשניהם. ספריות לקוח ב-Cloud תומכות ב-gRPC וב-REST ממשקים שונים, ספריות הלקוח של Google API תומכות רק בממשק REST, אבל יכול להשתמש בשתי ספריות הלקוח באותו הפרויקט. אופציונלי: אם ספריות הלקוח שסופקו לא עונות על הצרכים שלך, תוכל לכתוב ספריות לקוח שמשתמשות בממשק gRPC או REST.

מידע נוסף על הסוגים של ספריות הלקוח ש-Google תומכת בהם, הסבר על ספריות לקוח.

התקנת ספריות לקוח של Cloud (מומלץ)

ספריות לקוח ב-Cloud הן ספריות הלקוח העדכניות והמומלצות ביותר להתקשרות Chat API. ספריות לקוח ב-Cloud תומכות גם ב-gRPC וגם ב-REST ממשקים.

ב-Chat API יש ספריות לקוח של Cloud בשפות הבאות. בוחרים את השפה הרצויה:

Node.js

כדי להתקין את ספריית הלקוח:

npm install @google-apps/chat

למידע נוסף:

Python

כדי להתקין את ספריית הלקוח:

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

למידע נוסף:

Java

אפשר לבחור את סביבת ה-build שלך מהכרטיסיות הבאות. בכל מקרה, להשתמש, הקפידו לעדכן את הגרסה לגרסה העדכנית ביותר שזמינה בתאריך 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>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-chat</artifactId>
  <version>0.9.0</version>
</dependency>

Gradle

אם משתמשים ב-Gradle בלי BOM, מוסיפים אותה ליחסי התלות:

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

SBT

אם משתמשים ב-SBT, צריך להוסיף את הקוד הזה ליחסי התלות:

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

למידע נוסף:

Go

מייבאים את חבילות Go לשירותי Google Cloud.

import "cloud.google.com/go"

כדי להתקין את החבילה במערכת:

  1. שינוי לספריית הפרויקט: cd /my/cloud/project.
  2. משיגים את החבילה שבה רוצים להשתמש:
go get cloud.google.com/go/chat

למידע נוסף:

Ruby

כדי להתקין את ספריית הלקוח:

gem install google-apps-chat

למידע נוסף:

PHP

כדי להתקין את ספריית הלקוח:

  1. אם יש צורך, מתקינים את מנהל התלות Composer.
  2. בממשק שורת הפקודה, מריצים את:
composer require google/apps-chat

למידע נוסף:

‎.NET

כדי להתקין את ספריית הלקוח:

התקנת החבילה Google.Apps.Chat.V1 מ-NuGet. הוספה אל בפרויקט בדרך הרגילה (למשל, באמצעות לחיצה ימנית על הפרויקט Visual Studio ובחירה באפשרות 'Manage NuGet Packages... '). ודאו להפעיל חבילות טרום-השקה (לדוגמה, בחשבון של Visual Studio NuGet) צריך לבדוק את האפשרות 'הכללת קדם-השקה' ).

כדי להתקין את חבילת NuGet, היכנסו אל Google.Apis ב-NuGet.org.

למידע נוסף:

התקנת ספריות הלקוח של Google API

חלופה לספריות לקוח ב-Cloud, ספריות הלקוח של Google API לספק גישה פרוגרמטית ל-Chat API באמצעות משאבי REST שיטות. אולי עדיף להשתמש ספריות הלקוח של Google API אם אתם משתמשים בשפה שאין לה ספריית הלקוח ב-Cloud, או אם מרחיבים פרויקט שכבר משתמש בה.

Chat API מספק את ספריות הלקוח של Google API עבור: בשפות שונות. בוחרים את השפה הרצויה:

Go

אתם יכולים לקבל את ספריית הלקוח העדכנית של Google Chat API ל-Go (אלפא). בנוסף, כדאי לעיין במדריך למפתחים של ספריית הלקוח.

Java

בדף הזה נסביר על תחילת השימוש ב-Google Chat API באמצעות ספריית הלקוח של Google API ל-Java. מידע נוסף זמין במשאבי העזרה הבאים:

הוספה של ספריית הלקוח לפרויקט

קובעים את סביבת ה-build ‏(Maven או Gradle) לפי הכרטיסיות הבאות:

JavaScript

כדאי לעיין במדריך למפתחים של ספריית הלקוח.

‎.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. מידע נוסף זמין במשאבי העזרה הבאים:

דרישות מערכת

התקנה של ספריית הלקוח

אפשר להשתמש במנהל חבילות או להוריד ולהתקין באופן ידני את ספריית הלקוח של 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. מידע נוסף זמין במשאבי העזרה הבאים:

התקנה של 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 Script, אפשר להשתמש שירות Chat מתקדם במקום להתקין ספריית לקוח.

אימות

כדי לשלוח קריאה ל-Chat API, צריך לבצע אימות. כל אחד רכיב ה-method של Chat API מחייב אימות משתמש (כדי לבצע פעולות או לגשת נתונים מטעם משתמש) או אימות אפליקציות (כדי לבצע פעולות או לגשת לנתונים בתור אפליקציית Chat). במידה מסוימת שיטות שתומכות גם באימות משתמשים וגם באימות אפליקציות.

למידע נוסף על אימות ב-Chat: סקירה כללית על אימות