اجرای نمونه کد

CURL

راه اندازی کنید

1. دستورالعمل‌های موجود در اسناد API را برای ایجاد یا انتخاب یک پروژه برای برنامه خود دنبال کنید و API را فعال کنید.
2. در کنسول ابری، یک کلید API ایجاد کنید.
3. در کنسول ابری، یک شناسه مشتری OAuth برای یک برنامه وب ایجاد کنید و https://developers.google.com/oauthplayground به عنوان URI تغییر مسیر استفاده کنید.
4. در OAuth 2.0 Playground ، settings پیکربندی OAuth 2.0 کلیک کنید.
5. تیک Use your own credentials را بزنید.
6. شناسه مشتری و راز مشتری ایجاد شده در مرحله 3 را وارد کنید.
7. در قسمت scopes، محدوده مورد استفاده در روش خود را تایپ کنید و روی Authorize APIs کلیک کنید.
8. (اختیاری) اگر با صفحه ورود به سیستم نمایش داده شد، حساب مورد استفاده را انتخاب کنید.
9. (اختیاری) اگر با صفحه مجوز نمایش داده شد، روی پذیرش کلیک کنید.
10. روی کد مجوز تبادل برای توکن‌ها کلیک کنید. یک توکن برگردانده می شود.
11. در نمونه کد cURL، [YOUR_API_KEY] را با کلید API تولید شده در مرحله 2 جایگزین کنید: 'https://www.googleapis.com/drive/v3/files?key= [YOUR_API_KEY] ' \
12. در نمونه کد cURL، [YOUR_ACCESS_TOKEN] را با نشانه دسترسی تولید شده در مرحله 10 جایگزین کنید: --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN] ' \

نمونه کد را اجرا کنید

از خط فرمان، دستور cURL را اجرا کنید. دستور باید شبیه به این باشد:

curl \
'https://www.googleapis.com/drive/v3/files?key=AIzaSyBiKcaoXmVApwnT24hitQG_dwjGvAj6Ddw' \
--header 'Authorization: Bearer ya29.a0ARrdaM_yQn9MWBpJgKPx880BSnRYIizRYIDz0JN9e66nSliIYpqNXmPsvv2ccfplCTG_U4b1' \
--header 'Accept: application/json' \
--compressed

جاوا اسکریپت

راه اندازی کنید

1. دستورالعمل‌های موجود در اسناد API را برای ایجاد یا انتخاب پروژه برای برنامه خود دنبال کنید و API را فعال کنید.
2. در کنسول ابری، یک کلید API ایجاد کنید.
3. در کنسول ابری، یک اعتبار شناسه مشتری OAuth برای یک «برنامه وب» ایجاد کنید و مبدا مجاز جاوا اسکریپت را برای شناسایی نشانی اینترنتی که از آن درخواست‌ها ارسال می‌کنید، تنظیم کنید، مانند http://localhost .
4. نمونه کد کامل را در یک فایل محلی قابل دسترسی به وب سرور خود، مانند /var/www/html/example.html کپی کنید.

5. خطی را در نمونه کد پیدا کنید که کلید API یا شناسه مشتری را تنظیم می کند و مقدار را با مقادیر تولید شده در مرحله 2 و 3 جایگزین کنید:

   • کلید API: gapi.client.setApiKey( YOUR_API_KEY );
   • شناسه مشتری OAuth 2.0: gapi.client.init({ 'clientId': ' YOUR_CLIENT_ID ',

نمونه کد را اجرا کنید

1. فایل را در مرورگر خود باز کنید، مانند http://localhost/example.html . توصیه می کنیم از یک مرورگر با کنسول اشکال زدایی مانند Google Chrome استفاده کنید.
2. (اختیاری) اگر با صفحه ورود به سیستم نمایش داده شد، حساب مورد استفاده را انتخاب کنید.
3. (اختیاری) اگر با صفحه مجوز نمایش داده شد، روی پذیرش کلیک کنید. کنسول اشکال زدایی باید پاسخ متد را به عنوان یک شی JSON نمایش دهد.

جاوا

پیش نیازها

• جاوا 1.7 یا بالاتر.
• درجه 7 یا بیشتر.

راه اندازی کنید

1. دستورالعمل‌های موجود در اسناد API را برای ایجاد یا انتخاب پروژه برای برنامه خود دنبال کنید و API را فعال کنید.
2. بسته به نوع داده ای که روش به آن دسترسی دارد، یک کلید API (داده های عمومی) ایجاد کنید یا یک شناسه مشتری OAuth 2.0 (داده های خصوصی) ایجاد کنید.
3. نوع برنامه را روی برنامه دسکتاپ تنظیم کنید.
4. اگر شناسه مشتری OAuth 2.0 ایجاد کرده اید، فایل JSON حاوی اطلاعات کاربری OAuth 2.0 خود را دانلود کنید. نام این فایل چیزی شبیه به client_secret_ CLIENTID .json است که در آن CLIENTID شناسه مشتری پروژه شما است.

5. در پوشه کاری خود، دستورات زیر را برای ایجاد یک ساختار پروژه جدید اجرا کنید:

   $ gradle init --type basic
   $ mkdir -p src/main/java src/main/resources
   

6. اگر در مرحله 2 یک شناسه مشتری OAuth 2.0 ایجاد کرده اید، نام فایل JSON را که دانلود کرده اید به client_secret.json تغییر دهید.

7. فایل تغییر نام یافته را در دایرکتوری src/main/resources که در مرحله 5 ایجاد کردید ذخیره کنید.

8. در پوشه کاری خود، فایل build.gradle را باز کرده و محتوای آن را با موارد زیر جایگزین کنید:

   apply plugin: 'java'
   apply plugin: 'application'
   
   mainClassName = 'ApiExample'
   sourceCompatibility = 1.7
   targetCompatibility = 1.7
   version = '1.0'
   
   repositories {
       mavenCentral()
   }
   
   dependencies {
       compile 'com.google.api-client:google-api-client:1.23.0'
       compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
       API_SPECIFIC_DEPENDENCY
   }
   

9. در فایل build.gradle ، خطی که می گوید API_SPECIFIC_DEPENDENCY با دستورالعملی برای کامپایل کد برای API که تماس می گیرید جایگزین کنید. در اینجا یک نمونه برای YouTube Analytics API آمده است:

   compile 'com.google.apis:google-api-services-youtubeAnalytics:v2-rev16-1.23.0'
   

   دستورالعمل از این الگو پیروی می کند:

   compile 'com.google.apis:google-api-services-API_NAME:API_VERSION-   revREVISION-CL_VERSION'
   

کجا:

• API_NAME نام API است که در GitHub برای API فهرست شده است. برای پیدا کردن نام، روی پیوند نسخه در کنار API خود در صفحه پشتیبانی شده Google APIs کلیک کنید. لینک نسخه به GitHub هدایت می شود. نام API در وسط بالای صفحه است و قبل از آن googleapis/google-apis-services- . به عنوان مثال، برای نسخه 3 از Drive API، API_NAME drive است.
• API_VERSION نسخه API است که برای API در زیر نام API در صفحه پشتیبانی شده Google APIs فهرست شده است.
• REVISION شماره ویرایش فهرست شده در مرجع JavaDoc برای API است. مرجع JavaDoc را می توان در https://googleapis.dev/java/google-api-services- API_NAME /latest/index.html پیدا کرد
• CL_VERSION نسخه کتابخانه مشتری است. این مقدار در مرجع JavaDoc نیز ظاهر می شود.
• از فهرست کاری خود، نمونه کد را از APIs Explorer به src/main/java/ApiExample.java کپی کنید. (نام کلاس در هر نمونه ApiExample است تا برای اجرای نمونه های مختلف نیازی به تغییر فایل build.gradle نداشته باشید.

نمونه کد را اجرا کنید

برای اجرای مثال از دستور زیر استفاده کنید:

  gradle -q run

نمونه باید درخواست API شما را اجرا کند و پاسخ STDOUT را چاپ کند. همچنین می‌توانید سرویسی را که تماس می‌گیرید بررسی کنید تا اثرات درخواست‌هایی را که داده‌ها را می‌نویسند، ببینید.

Node.js

پیش نیازها

• Node.js

• Google APIs Client Library برای Node.js:

  • اگر قبلاً کتابخانه مشتری را نصب نکرده اید، دستور زیر را اجرا کنید:

  npm install googleapis --save
  

  • اگر قبلاً کتابخانه مشتری را نصب کرده‌اید، توصیه می‌کنیم آن را به‌روزرسانی کنید تا مطمئن شوید که به‌روزترین کلاس‌ها را برای کتابخانه‌ای که آزمایش می‌کنید دارید. برای به روز رسانی کتابخانه مشتری، دستور زیر را اجرا کنید:

  npm update googleapis --save
  

راه اندازی کنید

1. دستورالعمل‌های موجود در اسناد API را برای ایجاد یا انتخاب پروژه برای برنامه خود دنبال کنید و API را فعال کنید.
2. بسته به نوع داده ای که روش به آن دسترسی دارد، یک کلید API (داده های عمومی) ایجاد کنید یا یک شناسه مشتری OAuth 2.0 (داده های خصوصی) ایجاد کنید.
3. نوع برنامه را روی برنامه دسکتاپ تنظیم کنید.
4. اگر شناسه مشتری OAuth 2.0 ایجاد کرده اید، فایل JSON حاوی اطلاعات کاربری OAuth 2.0 خود را دانلود کنید. نام این فایل چیزی شبیه به client_secret_ CLIENTID .json است که در آن CLIENTID شناسه مشتری پروژه شما است.
5. نمونه کد را در یک فایل محلی کپی کنید و نمونه را تغییر دهید تا کلید API یا فایل اسرار مشتری به درستی شناسایی شود. در نمونه، مقدار کلید API YOUR_API_KEY است و مکان فایل مخفی مشتری YOUR_CLIENT_SECRET_FILE.json است.

نمونه کد را اجرا کنید

برای اجرای مثال از دستور زیر استفاده کنید:

  node sample.js

اکثر نمونه ها یک پاسخ API (یا چیز دیگری) را در STDOUT چاپ می کنند.

PHP

پیش نیازها

• PHP 5.4 یا بالاتر با رابط خط فرمان (CLI) و پسوند JSON.
• ابزار مدیریت وابستگی Composer به صورت جهانی نصب شده است.

• Google APIs Client Library برای PHP:

  • اگر قبلاً کتابخانه مشتری را نصب نکرده اید، دستور زیر را اجرا کنید:

    composer require google/apiclient:^2.0
    

  • اگر قبلاً کتابخانه مشتری را نصب کرده‌اید، توصیه می‌کنیم آن را به‌روزرسانی کنید تا مطمئن شوید که به‌روزترین کلاس‌ها را برای کتابخانه‌ای که آزمایش می‌کنید دارید. برای به روز رسانی کتابخانه مشتری، دستور زیر را اجرا کنید:

    composer update google/apiclient --with-dependencies
    

نمونه کد را اجرا کنید

برای اجرای مثال از دستور زیر استفاده کنید:

  php sample.php

اکثر نمونه ها یک پاسخ API (یا چیز دیگری) را در STDOUT چاپ می کنند.

پایتون

پیش نیازها

• پایتون 2.7 یا پایتون 3.5+
• ابزار مدیریت بسته پیپ

• کتابخانه سرویس گیرنده Google APIs برای پایتون:

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

• کتابخانه های google-auth-oauthlib و google-auth-httplib2 برای مجوز کاربر:

  pip install --upgrade google-auth-oauthlib google-auth-httplib2
  

راه اندازی کنید

1. دستورالعمل‌های موجود در اسناد API را برای ایجاد یا انتخاب پروژه برای برنامه خود دنبال کنید و API را فعال کنید.
2. بسته به نوع داده ای که روش به آن دسترسی دارد، یک کلید API (داده های عمومی) ایجاد کنید یا یک شناسه مشتری OAuth 2.0 (داده های خصوصی) ایجاد کنید.
3. نوع برنامه را روی برنامه دسکتاپ تنظیم کنید.
4. اگر شناسه مشتری OAuth 2.0 ایجاد کرده اید، فایل JSON حاوی اطلاعات کاربری OAuth 2.0 خود را دانلود کنید. نام این فایل چیزی شبیه به client_secret_ CLIENTID .json است که در آن CLIENTID شناسه مشتری پروژه شما است.
5. نمونه کد را در یک فایل محلی کپی کنید و نمونه را تغییر دهید تا کلید API یا فایل اسرار مشتری به درستی شناسایی شود. در نمونه، مقدار کلید API YOUR_API_KEY است و مکان فایل مخفی مشتری YOUR_CLIENT_SECRET_FILE.json است.

نمونه کد را اجرا کنید

برای اجرای مثال از دستور زیر استفاده کنید:

  python sample.py

اکثر نمونه ها یک پاسخ API (یا چیز دیگری) را در STDOUT چاپ می کنند.

روبی

پیش نیازها

• روبی 2.0 یا بالاتر

• کتابخانه سرویس گیرنده Google APIs برای Ruby:

  gem install google-api-client`
  

راه اندازی کنید

1. دستورالعمل‌های موجود در اسناد API را برای ایجاد یا انتخاب پروژه برای برنامه خود دنبال کنید و API را فعال کنید.
2. بسته به نوع داده ای که روش به آن دسترسی دارد، یک کلید API (داده های عمومی) ایجاد کنید یا یک شناسه مشتری OAuth 2.0 (داده های خصوصی) ایجاد کنید.
3. نوع برنامه را روی برنامه دسکتاپ تنظیم کنید.
4. اگر شناسه مشتری OAuth 2.0 ایجاد کرده اید، فایل JSON حاوی اطلاعات کاربری OAuth 2.0 خود را دانلود کنید. نام این فایل چیزی شبیه به client_secret_ CLIENTID .json است که در آن CLIENTID شناسه مشتری پروژه شما است.
5. نمونه کد را در یک فایل محلی کپی کنید و نمونه را تغییر دهید تا کلید API یا فایل اسرار مشتری به درستی شناسایی شود. در نمونه، مقدار کلید API YOUR_API_KEY است و مکان فایل مخفی مشتری YOUR_CLIENT_SECRET_FILE.json است.

نمونه کد را اجرا کنید

برای اجرای مثال از دستور زیر استفاده کنید:

  ruby sample.rb

اکثر نمونه ها یک پاسخ API (یا چیز دیگری) را در STDOUT چاپ می کنند.