با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
API Manufacturer Center (MfC) به برنامه‌ها اجازه می‌دهد تا مستقیماً با پلتفرم Manufacturer Center تعامل داشته باشند. برای کمک به شما برای شروع، نمونه کدهای جاوا و دات نت را ارائه می دهیم.
این راهنما به شما کمک می کند اولین برنامه خود را با استفاده از Manufacturer Center API ایجاد کنید. قبل از اینکه بتوانید کدنویسی را شروع کنید، چند کار وجود دارد که باید انجام دهید.
پشتیبانی REST
REST API ما از عملیات پایه CRUD برای 2 نوع مختلف منبع پشتیبانی می کند:
حتماً به خاطر داشته باشید که از کدام ایمیل برای ایجاد این حساب Manufacturer Center استفاده کرده اید، زیرا بعداً به آن نیاز خواهید داشت. در اسکرین‌شات‌ها، آن را به‌عنوان manufacturer_user@example.com نشان می‌دهید.
اولین درخواست API خود را انجام دهید (بدون خط کد!)
به APIs Explorer در اسناد برنامه‌نویس ما برای Accounts.Products.list بروید.
اطمینان حاصل کنید که حساب Google وارد شده در تنظیمات «کاربران» در برگه تنظیمات فهرست شده است.
در APIs Explorer، مطمئن شوید که Google OAuth 2.0 در منوی کشویی Authentication انتخاب شده است:
accounts/{account_id} را وارد کنید و {account_id} با شناسه سازنده خود از حساب Manufacturer Center خود در فیلد "والد" فرم جایگزین کنید و روی اجرا کلیک کنید.
شما باید یک پاسخ موفق را ببینید. تبریک می گویم! شما اولین درخواست Manufacturer Center API خود را ارائه کرده اید.
اگر هنوز محصولی در Manufacturer Center خود ندارید، هیچ محصولی در لیست وجود نخواهد داشت. در این مرحله، می‌توانید به درخواست‌های دیگر بروید و به کارهایی که انجام می‌دهند نگاهی بیندازید. از آنجایی که این یک API RESTful است، همه درخواست ها به طور مشابه کار می کنند. یک قدم خوب بعدی، هنگامی که محصولات دارید، امتحان Accounts.Products.get است.
یک پروژه Google API Console ایجاد کنید
درخواست‌ها به Manufacturer Center API از طریق پروژه کنسول API شما انجام می‌شود. در اینجا فرض می‌کنیم که به حساب Manufacturer Center خود دسترسی خواهید داشت، بنابراین پیشنهاد می‌کنیم از حساب‌های سرویس برای ساده‌سازی جریان احراز هویت استفاده کنید. راهنمای حساب‌های سرویس را برای جزئیات نحوه راه‌اندازی یک حساب سرویس جدید برای استفاده با حساب Manufacturer Center خود ببینید.
اولین درخواست مجاز API شما با استفاده از جاوا
اکنون که یک حساب سرویس راه‌اندازی کرده‌اید و شناسه حساب سرویس را به حساب Manufacturer Center خود اضافه کرده‌اید، می‌توانید با استفاده از کد نمونه موجود به حساب خود دسترسی داشته باشید. این راهنما از نمونه های جاوا برای نشان دادن استفاده از API استفاده می کند.
Apache Maven را نصب کنید، اگر قبلاً نصب نکرده اید.
اگر دستورالعمل‌های پیکربندی را در README همراه فایل‌های منبع دنبال نکرده‌اید، با خطایی مواجه می‌شوید که پیکربندی نمونه‌ای پیدا نشد. برای ایجاد دایرکتوری پیکربندی و پر کردن آن با اطلاعات مناسب، دستورالعمل های موجود در README را دنبال کنید. فایل JSON که هنگام راه‌اندازی حساب سرویس خود دانلود کرده‌اید، باید در آن فهرست با نام فایل service-account.json قرار گیرد. به خاطر داشته باشید که با تنظیم متغیر محیطی زیر به کد بگویید فایل شما کجاست.
در این مرحله، برنامه جاوا باید اجرای خود را به پایان برساند و لیستی از محصولاتی را که پیدا کرده است یا پیامی مبنی بر اینکه هیچ محصولی در حساب شما وجود ندارد چاپ کند. اگر با خطایی مانند "کاربر نمی تواند به حساب 1234567890 دسترسی پیدا کند" دریافت کردید، به احتمال زیاد به این دلیل است که کاربر حساب سرویس را به عنوان یک کاربر مجاز در Manufacturer Center تنظیم نکرده اید. از نقطه نظر API، پروژه API Console درخواستی را از طرف کاربری ارسال کرد که در لیست مدیران مجاز Manufacturer Center نبود، بنابراین مطمئناً آن درخواست را رد می کرد.
می‌توانید اجرای ProductsListSample هر چند بار که بخواهید آزمایش کنید، زیرا این درخواست فقط خواندنی است. همچنین می‌توانید نمونه‌های دیگری را که هم برای جاوا و هم برای دات‌نت ایجاد کرده‌ایم کاوش کنید.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
