این صفحه توضیح می دهد که چگونه می توانید یک حساب Merchant Center ایجاد کنید و یک محصول نمونه را با استفاده از Merchant API آپلود کنید.
قبل از شروع
Merchant API را در پروژه Google Cloud خود فعال کنید.
یک حساب کاربری ایجاد کنید
برای استفاده از Merchant API، باید یک حساب Merchant Center داشته باشید. برای ایجاد حساب Merchant Center، به شروع با Merchant Center مراجعه کنید.
شناسه حساب خود را دریافت کنید
با استفاده از روش accounts.list می توانید شناسه حساب را دریافت کنید.
می‌توانید از Google APIs Explorer برای اجرای درخواست‌های Merchant API استفاده کنید. APIs Explorer از Google OAuth 2.0 برای احراز هویت استفاده می کند. قبل از اجرای درخواست‌ها، مطمئن شوید که چک باکس Google OAuth 2.0 تیک خورده است.
برای احراز هویت با استفاده از OAuth 2.0، باید به حساب Google خود وارد شوید و سپس وارد APIs Explorer شوید. همچنین باید به APIs Explorer اجازه دهید تا فهرست‌های محصولات و حساب‌های شما را مدیریت کند.
درخواست زیر نشان می دهد که چگونه می توانید شناسه حساب خود را بازیابی کنید:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
پس از اجرای موفقیت آمیز درخواست، پاسخ زیر را مشاهده می کنید:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
{ACCOUNT_ID} را کپی کنید زیرا برای اجرای سایر درخواست‌ها به آن نیاز دارید.
یک منبع داده محصولات اولیه ایجاد کنید
برای درج یک محصول، به منبع داده محصولات اولیه نیاز دارید. درخواست زیر نحوه ایجاد یک منبع داده را نشان می دهد که می توانید از آن برای درج محصول در حساب خود استفاده کنید:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1
{
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
{ACCOUNT_ID} را با شناسه حساب Merchant Center که ایجاد کردید جایگزین کنید.
پس از اجرای موفقیت آمیز این درخواست، پاسخ زیر را مشاهده می کنید:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
مقدار فیلد name را کپی کنید زیرا برای درج محصول به آن نیاز خواهید داشت.
چند دقیقه طول می کشد تا منبع داده ایجاد شده برای درج محصولات در دسترس باشد.
می‌توانید این منبع داده را در رابط کاربری Merchant Center مشاهده کنید. برای اطلاعات بیشتر، نحوه یافتن برگه منابع داده را ببینید.
درج یک محصول
برای درج نمونه محصول در حساب خود، درخواست زیر را اجرا کنید:
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1
{
"channel": "ONLINE",
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"attributes": {
"gender": "Male",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
مقداری را که قبلاً کپی کردید جایگزین {DATASOURCE_NAME} کنید.
پس از اجرای موفقیت آمیز این درخواست، پاسخ زیر را مشاهده می کنید:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
"channel": "ONLINE",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"attributes": {
"brand": "New brand",
"gender": "Male"
}
}
شناسه محصول برای محصول جدید ایجاد شده online~en~US~tshirt-123 . برای بازیابی جزئیات این محصول می توانید از روش accounts.products.get استفاده کنید. همچنین می توانید از رابط کاربری Merchant Center برای مشاهده این محصول استفاده کنید .