استفاده از حساب‌های سرویس OAuth 2.0 با Manufacturer Center API

حساب‌های سرویس، حساب‌های Google ویژه‌ای هستند که می‌توانند توسط برنامه‌ها برای دسترسی برنامه‌نویسی به Google API از طریق OAuth 2.0 استفاده شوند. یک حساب سرویس از یک جریان OAuth 2.0 استفاده می کند که به مجوز اضافی نیاز ندارد. در عوض، از یک فایل کلیدی استفاده می کند که فقط برنامه شما می تواند به آن دسترسی داشته باشد. این راهنما نحوه دسترسی به Manufacturer Center API با حساب‌های سرویس را مورد بحث قرار می‌دهد.

پیش نیازها

مراحل استفاده از حساب سرویس برای دسترسی به Manufacturer Center API

  1. اعتبارنامه‌های حساب سرویس ایجاد کنید یا به اعتبارنامه‌های عمومی که قبلاً ایجاد کرده‌اید دسترسی پیدا کنید. شما باید یک شناسه مشتری OAuth 2.0 ایجاد کنید و یک فایل کلید خصوصی *.json دریافت کنید:

    1. به کنسول API Google بروید.

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

    3. اگر قبلاً Manufacturer Center API را برای این پروژه فعال نکرده‌اید، آن را در فهرست APIهای Google جستجو کرده و آن را فعال کنید.

    4. در نوار کناری سمت چپ، اعتبارنامه ها را انتخاب کنید.

    5. برای تنظیم یک حساب سرویس، Create credentials و سپس Service key account account را انتخاب کنید.

    اسکرین شات اعتبار حساب کاربری سرویس ایجاد کنید.

    1. در صفحه بعد، حساب کاربری جدید را از لیست کشویی انتخاب کنید.

    2. حساب سرویس جدید را نام ببرید. این همچنین به عنوان نام کاربری پیش‌فرض برای شناسه حساب سرویس عمل می‌کند. شناسه حساب سرویس را برای استفاده در آینده به خاطر بسپارید.

    اسکرین شات نام حساب سرویس جدید.

    1. JSON را برای نوع کلید انتخاب کنید، سپس روی ایجاد کلیک کنید.

    2. دکمه Create به Creating... تغییر می کند و پس از اتمام تولید کلید، به طور خودکار کلید خصوصی را به عنوان یک فایل *.json دانلود می کند.

    1. شما به صفحه اعتبارنامه بازگردانده می شوید و باید حساب سرویس جدید را در لیست کلیدهای حساب سرویس برای حساب خود مشاهده کنید.

  2. حساب سرویس جدید را به عنوان کاربر به حساب Manufacturer Center خود اضافه کنید. اگر شما یک توسعه دهنده شخص ثالث هستید، باید از مشتری خود بخواهید این مرحله را برای شما انجام دهد.

    1. به حساب Manufacturer Center خود بروید.

    2. در تنظیمات حساب Manufacturer Center خود به لیست «کاربران» بروید.

    3. روی دکمه +User کلیک کنید و از شناسه حساب سرویس به عنوان آدرس ایمیل کاربر جدید استفاده کنید.

      عکس صفحه دکمه کاربر حساب کاربری را اضافه کنید.

    4. فرم را با شناسه حساب سرویس پر کنید و نقش(های) کاربر مورد نظر را انتخاب کنید. حداقل یکی باید انتخاب شود و استفاده از سرویس Accounts به نقش مدیر نیاز دارد.

    اگر قبلاً شناسه حساب سرویس را یادداشت نکرده‌اید، به صفحه مدیریت حساب‌های سرویس بروید و پروژه‌ای را که ایجاد کرده‌اید انتخاب کنید.

    اضافه کردن اسکرین شات صفحه کاربری حساب سرویس.

    1. بر روی دکمه ذخیره کلیک کنید. شما به لیست کاربران بازگردانده می‌شوید و شناسه حساب سرویس باید با نقش(های) کاربر انتخابی فهرست شود.

    2. این فرآیند را برای همه حساب‌های سرویس دیگری که می‌خواهید اضافه کنید، تکرار کنید.

    3. با رفتن به تب کاربران، کاربران حساب های سرویس موجود را مشاهده کنید. اینها کاربرانی خواهند بود که آدرس ایمیلشان به «gserviceaccount.com» ختم می‌شود.

  3. اکنون می‌توانید با استفاده از جریان اعتبارنامه پیش‌فرض Google Application یا با استفاده مستقیم از جریان حساب سرویس، به حساب Manufacturer Center خود با استفاده از حساب سرویس دسترسی پیدا کنید. نمونه های Manufacturer Center API نشان می دهد که چگونه از هر دو جریان برای اعتبار حساب سرویس در هر زبان برنامه نویسی پشتیبانی شده استفاده کنید. نمونه‌های کد را ببینید تا حساب سرویس جدید خود را امتحان کنید و بدانید که برای استفاده از حساب‌های سرویس در کد خود به چه تغییراتی نیاز دارید.

سوالات متداول

آیا می توانم با حساب سرویس خود وارد رابط کاربری وب Manufacturer Center شوم؟

خیر، حساب‌های سرویس، حساب‌های Google معمولی نیستند و نمی‌توانند به رابط کاربری وب Manufacturer Center دسترسی داشته باشند.

هر چند وقت یک‌بار باید نشانه‌های دسترسی به حساب سرویس را بازخوانی کنم؟

توکن‌های دسترسی یک ساعت پس از صدور توسط سرور مجوز Google OAuth 2.0 منقضی می‌شوند. هنگامی که یک نشانه دسترسی منقضی می شود، برنامه باید از کتابخانه مشتری برای واکشی نشانه دسترسی دیگری استفاده کند.