OAuth را برای برنامه Android خود تنظیم کنید

APIهای Home از OAuth 2.0 برای اعطای دسترسی به دستگاه‌های موجود در ساختار استفاده می‌کنند. OAuth به کاربر اجازه می‌دهد تا بدون افشای اعتبار ورود به سیستم، به یک برنامه یا سرویس مجوز دهد.

اگر قبلاً یک سرویس گیرنده OAuth تأیید شده دارید (مثلاً از یک برنامه قبلاً منتشر شده)، می توانید از آن سرویس گیرنده برای آزمایش API های Home بدون تنظیم یک برنامه جدید استفاده کنید. برای اطلاعات بیشتر، ببینید آیا یک سرویس گیرنده OAuth موجود دارید .

برنامه را امضا کنید

ابتدا با اجرای برنامه خود در Android Studio یک کلید OAuth ایجاد کنید. وقتی برنامه‌ای را در Android Studio اجرا یا اشکال‌زدایی می‌کنید، به‌طور خودکار یک کلید OAuth ایجاد می‌کند که برای توسعه و اشکال‌زدایی در نظر گرفته شده است. برای توضیح کامل به Android Studio مراجعه کنید: بیلد اشکال زدایی خود را امضا کنید .

پس از اجرای برنامه:

  1. دستگاه تلفن همراه خود را به دستگاه محلی خود وصل کنید. Android Studio دستگاه های متصل شما را بر اساس شماره مدل فهرست می کند. دستگاه خود را از لیست انتخاب کنید، سپس روی اجرای پروژه کلیک کنید. این برنامه نمونه برنامه را روی دستگاه تلفن همراه شما ساخته و نصب می کند.

    برای دستورالعمل‌های دقیق‌تر، به اجرای برنامه‌ها در دستگاه سخت‌افزاری در سایت Android Developers مراجعه کنید.

  2. برنامه در حال اجرا را متوقف کنید.

  3. با دنبال کردن دستورالعمل‌های مشروح در راه‌اندازی OAuth 2.0 / Native applications / Android در سایت راهنمای Google Cloud Console، اثرانگشت SHA-1 گواهی OAuth را دریافت کنید.

  1. در کنسول Google Cloud، به داشبورد انتخابگر پروژه بروید و پروژه ای را که می خواهید برای ایجاد اعتبار OAuth استفاده کنید، انتخاب کنید.
  2. به صفحه APIs and Services بروید و روی Credentials در منوی پیمایش کلیک کنید.

  3. اگر هنوز صفحه رضایت خود را برای این پروژه Google Cloud پیکربندی نکرده‌اید، دکمه پیکربندی صفحه رضایت ظاهر می‌شود. در این صورت، صفحه رضایت خود را با استفاده از روش زیر پیکربندی کنید. در غیر این صورت به بخش بعدی بروید.

    1. روی پیکربندی صفحه رضایت کلیک کنید. صفحه رضایت OAuth نمایش داده می شود.
    2. بسته به مورد استفاده خود، Internal یا External را انتخاب کنید و سپس روی ایجاد کلیک کنید. صفحه نمایش رضایت OAuth نمایش داده می شود.
    3. اطلاعات را در صفحه اطلاعات برنامه مطابق دستورالعمل های روی صفحه وارد کنید و سپس روی ذخیره کلیک کنید و ادامه دهید . صفحه Scopes نمایش داده می شود.
    4. نیازی به اضافه کردن هیچ محدوده ای ندارید، بنابراین روی ذخیره کلیک کنید و ادامه دهید . صفحه کاربران تست نمایش داده می شود.
    5. اگر می‌خواهید کاربرانی را برای دسترسی آزمایشی به برنامه خود اضافه کنید، روی افزودن کاربران کلیک کنید. صفحه افزودن کاربران نمایش داده می شود. کاربران آزمایشی این امتیاز را دارند که به برنامه شما مجوز بدهند.
    6. در فیلد خالی، یک یا چند آدرس ایمیل حساب Google اضافه کنید و سپس روی افزودن کلیک کنید.
    7. روی ذخیره کلیک کنید و ادامه دهید . پنجره Summary نمایش داده می شود.
    8. اطلاعات صفحه رضایت OAuth خود را مرور کنید و سپس روی بازگشت به داشبورد کلیک کنید.

برای جزئیات کامل به تنظیم صفحه رضایت OAuth در سایت راهنمای Google Cloud Console مراجعه کنید.

برنامه را ثبت کنید و اعتبار ایجاد کنید

برای ثبت برنامه برای OAuth 2.0 و ایجاد اعتبارنامه OAuth، دستورالعمل های ارائه شده در راه اندازی OAuth 2.0 را دنبال کنید. باید نوع برنامه را که بومی/برنامه اندروید است مشخص کنید.

با دنبال کردن دستورالعمل‌های موجود در راه‌اندازی OAuth 2.0 / برنامه‌های بومی در سایت راهنمای Google Cloud Console، اثر انگشت SHA-1 را که از امضای برنامه دریافت کردید، به مشتری OAuth که در کنسول Google Cloud تنظیم کرده‌اید، اضافه کنید.

هنگامی که دستگاه تلفن همراه خود به دستگاه محلی خود متصل است، دستگاه خود را از لیست انتخاب کنید، سپس دوباره روی اجرای پروژه کلیک کنید تا آن را اجرا کنید. برای دستورالعمل‌های دقیق‌تر، به اجرای برنامه‌ها در دستگاه سخت‌افزاری در سایت Android Developers مراجعه کنید.

اگر مشتری OAuth موجود دارید

اگر از قبل یک سرویس گیرنده OAuth تأیید شده برای یک برنامه منتشر شده دارید، می توانید از سرویس گیرنده OAuth موجود خود برای آزمایش API های Home استفاده کنید.

ثبت نام Google Home Developer Console برای آزمایش و استفاده از APIهای Home لازم نیست. با این حال، حتی اگر یک سرویس گیرنده OAuth تأیید شده از ادغام دیگری داشته باشید، همچنان برای انتشار برنامه خود به ثبت نام Developer Console تأیید شده نیاز دارید.

ملاحظات زیر اعمال می شود:

  • هنگام استفاده از یک سرویس گیرنده OAuth موجود، یک محدودیت 100 کاربر وجود دارد. برای اطلاعات در مورد افزودن کاربران آزمایشی، به تنظیم صفحه رضایت OAuth مراجعه کنید. مستقل از تأیید OAuth، محدودیت 100 کاربر توسط Home API تحمیل شده است که می توانند به برنامه شما مجوز دهند. این محدودیت با تکمیل ثبت نام Developer Console برداشته می شود.

  • ثبت نام Developer Console باید زمانی برای تأیید ارسال شود که برای آماده‌سازی برای به‌روزرسانی برنامه خود با APIهای Home آماده باشید تا کمک هزینه‌های نوع دستگاه را از طریق OAuth محدود کنید.

برای برنامه‌های Google Cloud که هنوز در انتظار تأیید OAuth هستند، کاربران نمی‌توانند جریان OAuth را تکمیل کنند تا اینکه تأیید کامل شود. تلاش برای اعطای مجوز با خطای زیر ناموفق خواهد بود:

Access blocked: <Project Name> has not completed the Google verification process.