مراحل توضیح داده شده در ادامه این صفحه را تکمیل کنید تا یک برنامه خط فرمان ساده Ruby ایجاد کنید که درخواست هایی را به Classroom API ارسال می کند.
پیش نیازها
برای اجرای این شروع سریع، به پیش نیازهای زیر نیاز دارید:
- روبی 2.0 یا بالاتر
- یک پروژه Google Cloud Platform با فعال کردن API. برای ایجاد پروژه و فعال کردن API به Create a project مراجعه کنید و API را فعال کنید
- اعتبار مجوز برای یک برنامه دسکتاپ. برای یادگیری نحوه ایجاد اعتبار برای یک برنامه دسکتاپ، به ایجاد اعتبارنامه مراجعه کنید.
- حساب AG Suite for Education با Google Classroom فعال است.
مرحله 1: کتابخانه Google Client را نصب کنید
برای نصب کتابخانه دستور زیر را اجرا کنید:
gem install google-api-client
برای گزینه های نصب جایگزین به صفحه نصب کتابخانه مراجعه کنید.
مرحله 2: نمونه را تنظیم کنید
یک فایل با نام quickstart.rb
در پوشه کاری خود ایجاد کنید و در کد زیر کپی کنید:
مرحله 3: نمونه را اجرا کنید
نمونه را با استفاده از دستور زیر اجرا کنید:
ruby quickstart.rb
اولین باری که نمونه را اجرا میکنید، از شما میخواهد که دسترسی را مجاز کنید:
نمونه تلاش می کند یک پنجره یا برگه جدید در مرورگر پیش فرض شما باز کند. اگر این کار انجام نشد، URL را از کنسول کپی کنید و به صورت دستی آن را در مرورگر خود باز کنید.
اگر قبلاً وارد حساب Google خود نشدهاید، از شما خواسته میشود که وارد شوید. اگر به چندین حساب Google وارد شدهاید، از شما خواسته میشود یک حساب را برای استفاده برای مجوز انتخاب کنید.
- روی دکمه Accept کلیک کنید.
- نمونه به طور خودکار ادامه مییابد، و میتوانید پنجره/برگه را ببندید.
یادداشت
- اطلاعات مجوز در سیستم فایل ذخیره می شود، بنابراین اجرای بعدی درخواست مجوز نمی کند.
- جریان مجوز در این مثال برای یک برنامه کاربردی خط فرمان طراحی شده است. برای کسب اطلاعات در مورد نحوه اجرای مجوز در یک برنامه وب، به استفاده از OAuth 2.0 برای برنامه های وب سرور مراجعه کنید.
عیب یابی
این بخش برخی از مشکلات رایجی را که ممکن است هنگام تلاش برای اجرای این شروع سریع با آنها مواجه شوید، توضیح میدهد و راهحلهای ممکن را پیشنهاد میکند.
This app isn't verified
اگر صفحه رضایت OAuth اخطار «این برنامه تأیید نشده است» را نشان میدهد، برنامه شما دامنههایی را درخواست میکند که دسترسی به دادههای حساس کاربر را فراهم میکند. اگر برنامه شما از محدوده های حساس استفاده می کند، برنامه شما باید مراحل تأیید را طی کند تا آن هشدار و سایر محدودیت ها را حذف کند. در مرحله توسعه، میتوانید با انتخاب Advanced > Go to {Project Name} (ناامن) از این هشدار عبور کنید.
File not found error for credentials.json
هنگام اجرای نمونه، ممکن است فایلی را دریافت کنید که یافت نشد یا چنین خطای فایلی در مورد credentials.json وجود نداشته باشد.
این خطا زمانی رخ می دهد که اعتبار برنامه دسکتاپ را همانطور که در بخش پیش نیازها در بالا توضیح داده شده است، تأیید نکرده باشید. برای یادگیری نحوه ایجاد اعتبار برای یک برنامه دسکتاپ، به ایجاد اعتبارنامه بروید.
پس از ایجاد اعتبارنامه، مطمئن شوید که فایل JSON دانلود شده به عنوان credentials.json
ذخیره شده است. سپس فایل را با بقیه نمونه کد شروع سریع به دایرکتوری کاری خود منتقل کنید.
بیشتر خواندن
برای کسب اطلاعات بیشتر در مورد API های مورد استفاده در این شروع سریع، به بخش google-api-ruyby-client GitHub مراجعه کنید.