استخدام حسابات خدمة OAuth 2.0 مع واجهة برمجة تطبيقات Manufacturer Center
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُعد حسابات الخدمة حسابات خاصة على Google يمكن للتطبيقات استخدامها للوصول إلى Google APIs آليًا عبر OAuth 2.0. يستخدم حساب الخدمة تدفق OAuth 2.0 الذي لا يتطلب تفويضًا إضافيًا. بدلاً من ذلك، فإنه يستخدم ملف مفتاح
يمكن لتطبيقك فقط الوصول إليه. يناقش هذا الدليل كيفية الوصول إلى
واجهة برمجة تطبيقات Manufacturer Center باستخدام حسابات الخدمة.
الخطوات التي يجب اتّباعها لاستخدام حساب خدمة للوصول إلى Manufacturer Center API
يمكنك إنشاء بيانات اعتماد حساب الخدمة أو الوصول إلى بيانات الاعتماد العامة التي
أنشأتها. يجب إنشاء معرِّف عميل OAuth 2.0 والحصول على ملف مفتاح خاص بتنسيق *.json:
اختَر مشروعًا في القائمة المنسدلة في أعلى الصفحة. وإذا لم يكن لديك مشروع حتى الآن، يمكنك إنشاء مشروع بالنقر على إنشاء مشروع.
إذا لم يسبق لك تفعيل Manufacturer Center API لهذا المشروع، ابحث عنه في قائمة Google APIs وفعِّله.
في الشريط الجانبي على يمين الصفحة، اختَر بيانات الاعتماد.
لإعداد حساب خدمة، اختَر إنشاء بيانات اعتماد، ثم
مفتاح حساب الخدمة.
في الصفحة التالية، اختَر حساب خدمة جديد من القائمة المنسدلة.
أدخِل اسمًا لحساب الخدمة الجديد. ويعمل هذا أيضًا كاسم المستخدم التلقائي لمعرّف حساب الخدمة. تذكَّر رقم تعريف حساب الخدمة لاستخدامه لاحقًا.
اختَر JSON لنوع المفتاح، ثم انقر على إنشاء.
سيتغيّر الزر إنشاء إلى إنشاء...، وبعد انتهاء إنشاء المفتاح، سيتم تلقائيًا تنزيل المفتاح الخاص كملف *.json.
ستتم إعادتك إلى صفحة "بيانات الاعتماد"، وسيظهر لك حساب الخدمة الجديد في قائمة مفاتيح حساب الخدمة الخاص بحسابك.
أضِف حساب الخدمة الجديد كمستخدم إلى حسابك على Manufacturer Center.
إذا كنت مطوِّر تطبيقات تابعًا لجهة خارجية، يجب أن تطلب من عميلك تنفيذ
هذه الخطوة نيابةً عنك.
انتقِل إلى قائمة "المستخدمون" في إعدادات حسابك على
Manufacturer Center.
انقر على الزر +مستخدم، واستخدِم رقم تعريف حساب الخدمة كعنوان البريد الإلكتروني للمستخدم الجديد.
املأ النموذج باستخدام رقم تعريف حساب الخدمة،
واختَر أدوار المستخدمين المطلوبة. يجب اختيار موقع واحد على الأقل،
ويتطلّب استخدام خدمة Accounts دور المشرف.
إذا لم يسبق لك تدوين رقم تعريف حساب الخدمة، انتقِل إلى صفحة إدارة حسابات الخدمة واختَر المشروع الذي أنشأته.
انقر على الزر حفظ. ستتم إعادتك إلى قائمة المستخدمين،
ويجب إدراج رقم تعريف حساب الخدمة مع أدوار المستخدمين المحدّدة.
كرِّر العملية لجميع حسابات الخدمة الأخرى التي تريد إضافتها.
يمكنك الاطّلاع على مستخدمي حساب الخدمة الحاليين من خلال الانتقال إلى علامة التبويب "المستخدمون". سيكون هؤلاء
المستخدمون الذين لديهم عنوان بريد إلكتروني ينتهي بـ "gserviceaccount.com".
أصبح بإمكانك الآن الوصول إلى حسابك على Manufacturer Center باستخدام حساب الخدمة إمّا من خلال مسار بيانات الاعتماد التلقائية لتطبيق Google أو من خلال مسار حساب الخدمة مباشرةً. توضّح نماذج واجهة برمجة التطبيقات في Manufacturer Center
كيفية استخدام كلا المسارَين لبيانات اعتماد حساب الخدمة في كل لغة برمجة متوافقة. يمكنك الاطلاع على نماذج التعليمات البرمجية لتجربة حساب الخدمة الجديد ومعرفة التغييرات التي ستحتاج إليها لاستخدام حسابات الخدمة في الرمز البرمجي الخاص بك.
الأسئلة الشائعة
هل يمكنني تسجيل الدخول إلى واجهة مستخدم الويب في Manufacturer Center باستخدام حساب الخدمة الخاص بي؟
لا، حسابات الخدمة ليست حسابات Google عادية ولا يمكنها الوصول إلى واجهة مستخدم الويب Manufacturer Center.
كم مرة أحتاج إلى إعادة تحميل رموز الدخول إلى حساب الخدمة؟
تنتهي صلاحية رموز الدخول بعد ساعة واحدة من إصدارها بواسطة خادم تفويض OAuth 2.0
في Google. عند انتهاء صلاحية رمز الدخول، يجب أن يستخدم التطبيق
مكتبة البرامج لجلب رمز دخول آخر.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eService accounts enable applications to programmatically access the Manufacturer Center API using OAuth 2.0 without user intervention.\u003c/p\u003e\n"],["\u003cp\u003eTo use a service account, generate service account credentials in Google Cloud Console, enable the Manufacturer Center API, and download the JSON key file.\u003c/p\u003e\n"],["\u003cp\u003eAdd the service account as a user to your Manufacturer Center account with the appropriate role for API access.\u003c/p\u003e\n"],["\u003cp\u003eAccess your Manufacturer Center account programmatically using Google Application Default Credentials or the service account flow, referencing the provided samples.\u003c/p\u003e\n"],["\u003cp\u003eService accounts cannot be used to log into the Manufacturer Center web user interface but solely for API interaction.\u003c/p\u003e\n"]]],[],null,["# Using OAuth 2.0 service accounts with the Manufacturer Center API\n\nService accounts are special Google accounts that can be used by applications to\naccess Google APIs programmatically via OAuth 2.0. A service account uses an\nOAuth 2.0 flow that does not require additional authorization. Instead, it uses\na key file that only your application can access. This guide discusses how to\naccess the Manufacturer Center API with service accounts.\n| **Note:** Applications using service accounts for authentication can only access your own Manufacturer Center account. If you are writing a third-party application that needs access to your clients' Manufacturer Center accounts, see the [Authorizing Requests](/manufacturers/how-tos/authorizing) guide instead.\n\nPrerequisites\n-------------\n\n- A [Manufacturer Center](//manufacturers.google.com/) account.\n\nSteps to using a service account to access the Manufacturer Center API\n----------------------------------------------------------------------\n\n1. Generate service-account credentials or access the public credentials you've\n already generated. You will need to create an OAuth 2.0 Client ID and obtain\n a \\*.json private key file:\n\n 1. Go to the [Google API Console](https://console.cloud.google.com/apis/library).\n\n 2. Select a project in the drop-down menu at the top of the page. If you do\n not have one yet, create one by clicking **Create Project**.\n\n 3. If you have not already enabled the Manufacturer Center API for this\n project, then search for it in the list of Google APIs and enable it.\n\n 4. In the sidebar on the left, select **Credentials**.\n\n 5. To set up a service account, select **Create credentials** , and then\n **Service account key**.\n\n 1. On the next page, select **New service account** from the drop-down\n list.\n\n 2. Name the new service account. This\n also serves as the default username for the service account ID. Remember\n the service account ID for use later.\n\n | **Note:** The choice of role for the service account will not have any effect on what calls can be made to the Manufacturer Center API, as access to Manufacturer Center API methods is determined instead by the role associated with the service account ID in Manufacturer Center. If you are unsure what to pick, just pick Project►Viewer.\n\n 1. Select **JSON** for the key type, then click **Create**.\n\n 2. The **Create** button will change to **Creating...**, and once the key\n generation finishes, it will automatically download the private key as a\n \\*.json file.\n\n | **Important:** Protect the \\*.json key file that allows a service account to access the Google services for which it has been authorized. It is good practice to allow service accounts to only access one Google API each. This is a preventative measure to mitigate the amount of data an attacker can access in the situation that the service account's \\*.json key file is compromised.\n 1. You will be returned to the Credentials page, and you should see the new service account in the list of service account keys for your account.\n2. Add the new service account as a user to your Manufacturer Center account.\n If you are a third party developer, you will need to have your client do\n this step for you.\n\n 1. Go to your [Manufacturer Center account](//manufacturers.google.com/).\n\n 2. Go to the 'Users' list in the settings of your Manufacturer Center\n account.\n\n 3. Click the +User button, and use the service account ID as the email\n address for the new user.\n\n 4. Fill in the form with the [service account ID](#service-account-name),\n and select the desired user role(s). At least one must be chosen, and\n use of the `Accounts` service requires the Admin role.\n\n If you did not take note of the service account ID earlier, go to the\n [Service Accounts](https://console.developers.google.com/iam-admin/serviceaccounts/)\n administration page and select the project you created.\n\n 1. Click on the **Save** button. You will be returned to the list of users,\n and the service account ID should be listed with the chosen user role(s).\n\n 2. Repeat the process for all other service accounts you want to add.\n\n 3. View existing service account users by going to the Users tab. These\n will be users with an email address ending in 'gserviceaccount.com'.\n\n3. Now you can access your Manufacturer Center account using the service\n account either by using the [Google Application Default\n Credentials](/identity/protocols/application-default-credentials) flow or by\n using the [service account flow](/identity/protocols/OAuth2ServiceAccount)\n directly. The Manufacturer Center API [Samples](/manufacturers/libraries)\n show how to use both flows for service account credentials in each supported\n programming language. See the code samples to try out your new service\n account and to learn what changes you will need to use service accounts in\n your own code.\n\nFrequently asked questions\n--------------------------\n\n#### Can I log into the Manufacturer Center web user interface with my service account?\n\nNo, service accounts are not regular Google accounts and cannot access the\nManufacturer Center web user interface.\n\n#### How often do I need to refresh service account access tokens?\n\nAccess tokens expire one hour after they are issued by the Google OAuth 2.0\nAuthorization Server. When an access token expires, the application should use\nthe client library to fetch another access token."]]
