یک برنامه خط فرمان پایتون ایجاد کنید که درخواست هایی را به People API ارسال می کند.
Quickstarts نحوه راهاندازی و اجرای برنامهای را توضیح میدهد که Google Workspace API را فراخوانی میکند. این شروع سریع از یک رویکرد احراز هویت ساده استفاده می کند که برای یک محیط آزمایشی مناسب است. برای یک محیط تولید، توصیه میکنیم قبل از انتخاب اعتبارنامههای دسترسی مناسب برای برنامهتان، درباره احراز هویت و مجوز یاد بگیرید.
این شروع سریع از کتابخانه های سرویس گیرنده API توصیه شده Google Workspace برای رسیدگی به برخی از جزئیات جریان احراز هویت و مجوز استفاده می کند.
- محیط خود را تنظیم کنید.
- کتابخانه مشتری را نصب کنید.
- نمونه را تنظیم کنید
- نمونه را اجرا کنید.
برای اجرای این شروع سریع، به پیش نیازهای زیر نیاز دارید:
- پایتون 3.10.7 یا بالاتر
- ابزار مدیریت بسته پیپ
- یک پروژه Google Cloud .
- دامنه Google Workspace با دسترسی API فعال است .
- یک حساب Google در آن دامنه با امتیازات سرپرست.
برای تکمیل این شروع سریع، محیط خود را تنظیم کنید.
در کنسول Google Cloud، People API را فعال کنید.
اگر از یک پروژه Google Cloud جدید برای تکمیل این شروع سریع استفاده میکنید، صفحه رضایت OAuth را پیکربندی کنید. اگر قبلاً این مرحله را برای پروژه Cloud خود انجام داده اید، به بخش بعدی بروید.
- در کنسول Google Cloud، به > برویدGoogle Auth platform > برندسازی
- اگر قبلاً آن را پیکربندی کرده اید Google Auth platform، می توانید تنظیمات صفحه رضایت OAuth زیر را در نام تجاری ، مخاطب و دسترسی به داده پیکربندی کنید. اگر پیامی دیدید که می گوید Google Auth platform هنوز پیکربندی نشده است ، روی شروع کلیک کنید:
- در قسمت اطلاعات برنامه ، در نام برنامه ، نامی برای برنامه وارد کنید.
- در ایمیل پشتیبانی کاربر ، آدرس ایمیل پشتیبانی را انتخاب کنید که در صورت داشتن رضایت، کاربران بتوانند با شما تماس بگیرند.
- روی Next کلیک کنید.
- در قسمت Audience ، Internal را انتخاب کنید.
- روی Next کلیک کنید.
- در قسمت اطلاعات تماس ، آدرس ایمیلی را وارد کنید که در آن میتوانید از هرگونه تغییر در پروژه خود مطلع شوید.
- روی Next کلیک کنید.
- در قسمت پایان ، خطمشی دادههای کاربر سرویسهای API Google را مرور کنید و در صورت موافقت، من با خدمات Google API موافقم: خطمشی دادههای کاربر را انتخاب کنید.
- روی Continue کلیک کنید.
- روی ایجاد کلیک کنید.
- در حال حاضر، می توانید از افزودن دامنه ها صرف نظر کنید. در آینده، وقتی برنامهای را برای استفاده خارج از سازمان Google Workspace خود ایجاد میکنید، باید نوع کاربر را به خارجی تغییر دهید. سپس محدوده های مجوز مورد نیاز برنامه خود را اضافه کنید. برای کسب اطلاعات بیشتر، راهنمای کامل Configure OAuth رضایت را ببینید.
- در کنسول Google Cloud، به > برویدGoogle Auth platform > مشتریان
- روی Create Client کلیک کنید.
- روی نوع برنامه > برنامه دسکتاپ کلیک کنید.
- در قسمت نام ، نامی را برای اعتبارنامه تایپ کنید. این نام فقط در کنسول Google Cloud نشان داده می شود.
- روی ایجاد کلیک کنید.
اعتبار جدید ایجاد شده در زیر "OAuth 2.0 Client IDs" ظاهر می شود.
- فایل JSON دانلود شده را به عنوان
credentials.json
ذخیره کنید و فایل را به دایرکتوری کاری خود منتقل کنید.
کتابخانه کلاینت گوگل را برای پایتون نصب کنید:
pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib
- در پوشه کاری خود، یک فایل با نام
quickstart.py
ایجاد کنید. کد زیر را در
quickstart.py
قرار دهید:
در پوشه کاری خود، نمونه را بسازید و اجرا کنید:
python3 quickstart.py
- اولین باری که نمونه را اجرا میکنید، از شما میخواهد دسترسی را مجاز کنید:
- اگر قبلاً وارد حساب Google خود نشده اید، هنگامی که از شما خواسته شد وارد شوید. اگر به چندین حساب وارد شده اید، یک حساب را برای استفاده از مجوز انتخاب کنید.
- روی Accept کلیک کنید.
برنامه پایتون شما اجرا می شود و People API را فرا می خواند.
اطلاعات مجوز در سیستم فایل ذخیره می شود، بنابراین دفعه بعد که کد نمونه را اجرا می کنید، از شما درخواست مجوز نمی شود.
- عیب یابی مشکلات احراز هویت و مجوز
- اسناد مرجع People API
- Google APIs Client برای اسناد پایتون
- اسناد PyDoc API افراد