התקן ספריית לקוח

אם אתם לא רוצים לכתוב קוד משלכם כדי לשלוח בקשות HTTP ולנתח את התשובות, עליכם להוריד ספריית לקוח.

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

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

הערה: אחת המשימות העיקריות של ספריות הלקוח היא המרה בין JSON לבין אובייקטים מובנים. בספריית Java, הפעולה הזו מתבצעת באמצעות קבוצה של כיתות שמסופקות על ידי קובץ JAR. ב-Python, ה-JSON מומר ישירות למילתון או למחרוזת גיבוב.

Java

כדי להשתמש בספריית הלקוח של Google APIs ל-Java, צריך להוריד את ספריית הליבה של Java ואת ספריית Java של Activity API ב-Google Drive.

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

• מקורות מידע בנושא Javadoc בשביל Drive Activity API
• המדריך למפתחים לספריית הלקוח של Google API עבור Java
• תוכלו להשתמש ב-API הזה בדפדפן באמצעות APIs Explorer עבור Drive Activity API.

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

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

Maven

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

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

Gradle

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

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

Python

כדי להשתמש בספריית הלקוח של Google APIs ל-Python, צריך להוריד ולהתקין את קוד המקור של Python.

בדף הזה נסביר על תחילת השימוש ב-Drive Activity API באמצעות ספריית הלקוח של Google API ל-Python (v1/v2). מידע נוסף זמין במשאבי העזרה הבאים:

• מקורות מידע בנושא PyDoc ל-Drive Activity API
• המדריך למפתחים לספריית הלקוח של Google API ל-Python (גרסה 1/גרסה 2)
• תוכלו להשתמש ב-API הזה בדפדפן באמצעות APIs Explorer עבור Drive Activity API.

דרישות מערכת

• מערכות הפעלה:
  • Linux
  • macOS X
  • Windows
• בספריית הלקוח בגרסה 1 נדרש Python מגרסה 2.7 ואילך. כדי להשתמש בספריית הלקוח בגרסה 2, נדרשת גרסה 3.7 ואילך.

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

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

כדי לעשות זאת, מריצים את הפקודות הבאות:

$ hg clone https://google-api-python-client.googlecode.com/hg/ google-api-python-client
$ cd google-api-python-client
$ sudo python setup.py install

עכשיו אפשר לייבא את הכיתות הנדרשות באמצעות ההצהרות הבאות:

from apiclient.discovery import build
from apiclient.oauth import OAuthCredentials

import httplib2
import oauth2 as oauth

PHP

כדי להשתמש בספריית הלקוח של Google APIs ל-PHP, צריך להוריד ולהתקין את קוד המקור של PHP.

כדי לעשות זאת, מריצים את הפקודות הבאות:

$ svn checkout http://google-api-php-client.googlecode.com/svn/trunk/ google-api-php-client-read-only
$ cd google-api-php-read-only
$ # Copy the src directory to your working directory.

עכשיו אפשר לייבא את הכיתות הנדרשות באמצעות ההצהרות הבאות:

require_once "../src/apiClient.php";

‎.NET

כדי להשתמש בספריית הלקוח של Google APIs ל-‎ .NET, צריך להוריד את ספריית הלקוח הבסיסית ל-‎ .NET ואת ספריית ה-‎ .NET של Activity API ב-Google Drive. מורידים את הקבצים ומוסיפים אותם כמקורות מידע לפרויקט:

• ספריית הלקוח של הליבה
• ספריית Google Drive Activity API

עכשיו אפשר לייבא את הכיתות הנדרשות באמצעות ההצהרות הבאות:

using Google.Apis.Authentication;
using Google.Apis.Authentication.OAuth2;