احرص على تذكُّر عنوان البريد الإلكتروني الذي استخدمته لإنشاء حساب Manufacturer Center هذا.
الحساب، حيث ستحتاج إلى ذلك لاحقًا. في لقطات الشاشة، ستراها
ممثلة بالتنسيق manufacturer_user@example.com.
قدِّم أول طلب من واجهة برمجة التطبيقات (بدون إدخال أي رموز).
تأكَّد من أنّ حساب Google الذي تم تسجيل الدخول إليه مُدرَج في قسم "المستخدمون". الإعداد
في علامة التبويب "الإعدادات"
في "مستكشف واجهات برمجة التطبيقات"، تأكَّد من اختيار Google OAuth 2.0 في
القائمة المنسدلة المصادقة:
أدخِل accounts/{account_id}، مع استبدال {account_id} بـ
معرّف الشركة المصنّعة من حسابك على Manufacturer Center، إلى "الرقم الرئيسي"
في حقل النموذج، وانقر على تنفيذ.
من المفترض أن تظهر لك إجابة ناجحة. تهانينا! لقد أحرزت
أول طلب من واجهة برمجة التطبيقات في Manufacturer Center
إذا لم يكن لديك أي منتجات في Manufacturer Center بعد، لن يكون هناك أيّ منتج.
في القائمة. في هذه المرحلة، يمكنك الانتقال إلى الطلبات الأخرى وإلقاء نظرة على
وما يفعلونه. ولأنّ هذه الواجهة هي واجهة برمجة تطبيقات RESTful، تعمل جميع الطلبات بالطريقة نفسها. حاسمة
فإن الخطوة التالية الجيدة، بمجرد حصولك على المنتجات، هي محاولة
Accounts.Products.get
إنشاء مشروع على وحدة تحكُّم واجهة Google API
يتم إرسال الطلبات إلى واجهة برمجة تطبيقات Manufacturer Center من خلال مشروعك على وحدة تحكّم واجهة برمجة التطبيقات. ونفترض هنا أنك ستدخل إلى بياناتك الخاصة
حساب Manufacturer Center، لذا نقترح استخدام الخدمة
الحسابات لتبسيط
مسار المصادقة يُرجى الاطّلاع على الخدمة.
دليل الحسابات للحصول على تفاصيل حول كيفية
إعداد حساب خدمة جديد لاستخدامه مع حسابك على Manufacturer Center
أول طلب معتمد من واجهة برمجة التطبيقات باستخدام Java
بعد أن انتهيت الآن من إعداد حساب الخدمة وإضافة رقم تعريف حساب الخدمة إلى
حسابك على Manufacturer Center، يمكنك الوصول إلى حسابك باستخدام
عيّنات التعليمات البرمجية. يستخدم هذا الدليل لغة Java
العينات لتوضيح كيفية استخدامها.
في حال لم تتبع توجيهات الضبط في الملف التمهيدي
المصاحبة لملفات المصدر، فستحصل على خطأ يفيد بأنه لا توجد عينة
أي إعدادات حسابية. اتبع الإرشادات الواردة في الملف التمهيدي لإنشاء
دليل التهيئة وتعبئته ببيانات
المعلومات. ملف JSON الذي نزّلته أثناء إعداد الخدمة
في هذا الدليل باستخدام اسم الملف
service-account.json تذكر أن تخبر التعليمة البرمجية بمكان ملفك
إعداد متغير البيئة التالي.
في هذه المرحلة، من المفترض أن ينتهي برنامج Java من التنفيذ والطباعة
أو قائمة بالمنتجات التي عثر عليها، أو رسالة تفيد بعدم وجود
المنتجات في حسابك. إذا ظهرت لك رسالة خطأ مثل "يتعذّر على المستخدم الوصول إلى الملف"
الحساب 1234567890"، فإن السبب في ذلك على الأرجح هو أنك لم تقم بإعداد
مستخدم حساب الخدمة بصفته مستخدِمًا معتمَدًا في Manufacturer Center. من
وجهة نظر واجهة برمجة التطبيقات، أرسل مشروع وحدة تحكم واجهة برمجة التطبيقات طلبًا
بالنيابة عن مستخدم لم يكن مُدرَجًا في قائمة Manufacturer Center المعتمَد
والمشرفين، لذلك سيتم رفض هذا الطلب بالطبع.
يمكنك تجربة تشغيل ProductsListSample أكبر عدد ممكن من المرّات.
نريدها، لأنها طلب للقراءة فقط. يمكنك أيضًا استكشاف خيارات
والنماذج التي أنشأناها لكل من Java و .NET.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Manufacturer Center API allows direct interaction with the Manufacturer Center platform, offering code samples in Java and .NET to facilitate application development.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, you need to set up a Manufacturer Center account and make an initial API request using the API Explorer to authorize access.\u003c/p\u003e\n"],["\u003cp\u003eA Google API Console project with a service account is necessary to make requests to the Manufacturer Center API, enabling secure communication.\u003c/p\u003e\n"],["\u003cp\u003eYou can access your Manufacturer Center account using provided sample code (e.g., Java samples) after configuring a service account and adding it as an authorized user.\u003c/p\u003e\n"],["\u003cp\u003eThe samples demonstrate various API functionalities, including listing products and performing other read-only operations, allowing for experimentation and further exploration.\u003c/p\u003e\n"]]],[],null,["# Get Started\n\nThe Manufacturer Center (MfC) API allows apps to interact directly with the\n[Manufacturer Center platform](https://manufacturers.google.com). To help you\nget started, we offer [code samples](/manufacturers/libraries) in Java and .NET.\n\nThis guide will help you create your first application using the Manufacturer\nCenter API. Before you can start coding, there are a few things you need to do.\n\nREST Support\n------------\n\nOur REST API supports basic CRUD operations for 2 different types of resources:\n\n- [Product](/manufacturers/reference/rest/v1/accounts.products) for Brand Owners and Data Partners.\n- And [ProductCertification](/manufacturers/reference/rest/v1/accounts.languages.productCertifications) for Certification Bodies.\n\nThe rest of this documentation will be written mainly for [Product](/manufacturers/reference/rest/v1/accounts.products) but the process should be similar for [ProductCertification](/manufacturers/reference/rest/v1/accounts.languages.productCertifications).\n\nSet up your Manufacturer Center Account\n---------------------------------------\n\n1. Create a [Manufacturer Center\n Account](//support.google.com/manufacturers/answer/7064831).\n\n | **Note:** Certification Body users can't create an account this way but need to contact our support directly.\n2. Be sure to remember which email you used to create this Manufacturer Center\n account, as you will need that later. In the screenshots, you'll see it\n represented as **manufacturer_user@example.com**.\n\nMake your first API request (without a line of code!)\n-----------------------------------------------------\n\n1. Head over to the [APIs\n Explorer](/manufacturers/reference/rest/v1/accounts.products/list#try-it) in\n our developer documentation for `Accounts.Products.list`.\n\n2. Ensure that the logged in Google account is listed in the 'Users' setting\n in the Settings tab.\n\n3. In the APIs Explorer, make sure that **Google OAuth 2.0** is selected in the\n **Authentication** drop-down menu:\n\n4. Enter `accounts/{account_id}`, replacing `{account_id}` with your\n Manufacturer ID from your Manufacturer Center account, into the 'parent'\n field of the form, and click **Execute**.\n\n | **Note:** If you have not previously granted OAuth2 permission, you will now be asked to authorize the call.\n5. You should see a successful response. Congratulations! You've made your\n first Manufacturer Center API request.\n\n6. If you have no products in your Manufacturer Center yet, there won't be any\n in the list. At this point, you can hop to other requests and take a look at\n what they do. Since this is a RESTful API, all requests work similarly. A\n good next step, once you have products, is to try\n [`Accounts.Products.get`](/manufacturers/reference/rest/v1/accounts.products/get#try-it).\n\nCreate a Google API Console Project\n-----------------------------------\n\nRequests to the Manufacturer Center API are made through your API Console project. Here we assume you will be accessing your own\nManufacturer Center account, so we suggest using [service\naccounts](/identity/protocols/OAuth2ServiceAccount) to simplify the\nauthentication flow. See the [Service\nAccounts](/manufacturers/how-tos/service-accounts) Guide for details on how to\nset up a new service account to use with your Manufacturer Center account.\n| **Note:** If you are interested in making calls on behalf of clients with their own Manufacturer Center accounts, then see the [Authorize\n| Requests](/manufacturers/how-tos/authorizing) guide.\n\nYour first authorized API request using Java\n--------------------------------------------\n\nNow that you've set up a service account and added the service account ID to\nyour Manufacturer Center account, you can access your account using the\navailable [Samples code](/manufacturers/libraries). This guide uses the Java\nsamples to demonstrate using the API.\n\n1. Install [Apache Maven](https://maven.apache.org/), if you haven't already.\n\n2. Download our [Shopping\n samples](//github.com/googleads/googleads-shopping-samples/) from our GitHub\n page.\n\n3. From within the `java` subdirectory, build the Java samples:\n\n $ mvn compile\n\n4. Now run the `ProductsListSample` (the example for [ProductCertification](/manufacturers/reference/rest/v1/accounts.languages.productCertifications) would be `ListProductCertificationsSample`) code:\n\n $ mvn exec:java -Dexec.mainClass=\"shopping.manufacturers.v1.samples.products.ProductsListSample\"\n\n5. If you haven't followed the configuration directions in the README\n accompanying the source files, you will get an error that no sample\n configuration could be found. Follow the directions in the README to create\n the configuration directory and to populate it with the appropriate\n information. The JSON file you downloaded while setting up your service\n account should be placed in that directory with the filename\n `service-account.json`. Remember to tell the code where your file is by\n setting the following environment variable.\n\n export GOOGLE_APPLICATION_CREDENTIALS=\u003cPath to your JSON credentials file\u003e\n\n6. Now that you have set up the samples configuration, run the\n `ProductsListSample` code again.\n\n $ mvn exec:java -Dexec.mainClass=\"shopping.manufacturers.v1.samples.products.ProductsListSample\"\n\n7. At this point, the Java program should finish executing, and print out\n either a list of products that it found, or a message that there were no\n products in your account. If you get an error such as \"User cannot access\n account 1234567890\", it's most likely because you have not set up the\n service account user as an authorized user in Manufacturer Center. From the\n API's standpoint, the API Console project sent a request on\n behalf of a user who was not on the list of authorized Manufacturer Center\n administrators, so it would, of course, reject that request.\n\n8. You can experiment with running `ProductsListSample` as many times as you\n want, since it is a read-only request. You can also explore the other\n samples that we've created for both Java and .NET."]]
