ספריות הלקוח של 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

דוגמאות של ספריות לקוח ב-Cloud Node.js.

למידע נוסף:

• מאגר ב-GitHub
• חומר עזר בנושא ספריית הלקוח ב-Cloud
• מדריך למתחילים

Python

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

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

דוגמאות של ספריות לקוח ב-Cloud Python.

למידע נוסף:

• מאגר ב-GitHub
• חומר עזר בנושא ספריית הלקוח ב-Cloud
• מדריך למתחילים

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"

דוגמאות של ספריות לקוח ב-Cloud 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 ובחירה באפשרות 'Manage NuGet Packages... '). ודאו להפעיל חבילות טרום-השקה (לדוגמה, בחשבון של Visual Studio NuGet) צריך לבדוק את האפשרות 'הכללת קדם-השקה' ).

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

למידע נוסף:

• מאגר ב-GitHub
• חומר עזר בנושא ספריית הלקוח ב-Cloud

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

• מקורות מידע בנושא Javadoc בשביל Google Chat API.
• המדריך למפתחים לספריית הלקוח של Google API עבור Java

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

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

Maven

מוסיפים לקובץ pom.xml את הנתונים הבאים:

לכל הגרסאות הזמינות ב-Maven Central Repository

Gradle

מוסיפים לקובץ build.gradle את הנתונים הבאים:

לכל הגרסאות הזמינות ב-Maven Central Repository

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 נתמכת באופן רשמי ספריות לקוח ב-Cloud בשפה המועדפת, כמו Python או Java או Node.js.

אם מתכנתים באמצעות Google Apps Script, אפשר להשתמש שירות Chat מתקדם במקום להתקין ספריית לקוח.

אימות

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

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