rocket
تعرَّف على
Merchant API
الذي يحلّ رسميًا محلّ Content API for Shopping.
add_alert
ملاحظة: سيتم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026.
معرّفات المنتجات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في ما يلي الأنواع المختلفة من معرّفات المنتجات في Content API for Shopping:
- معرّف العرض
offerId عبارة عن سلسلة يحدّدها أحد التجّار لمنتج معيّن. يمثل هذا الرقم التعريفي
منتجًا فرديًا.- تتميز خدمة
offerId بمجموعة من العروض في قاعدة بيانات Merchant Center، وعادةً ما تكون رقمًا تسلسليًا رقميًا.
- يمكن أن يكون
offerId رقم رمز التخزين التعريفي الداخلي الذي يحدّده التاجر للمنتج.
- رقم تعريف REST
- معرّف REST هو المعرّف الفريد للمنتج الذي تحدّده Google.
- معرّف REST هو
productId لاستدعاء واجهة برمجة تطبيقات REST.
يتم تجميع أرقام تعريف REST بالتنسيق online:en:label:1111111111. يتألف معرّف REST من الأجزاء الأربعة التالية مفصولة بفواصل:
- القناة ("عبر الإنترنت" أو "المحلية")
- لغة المحتوى (باستخدام التصنيف المكوَّن من حرفين، على سبيل المثال
en أو fr)
- تصنيف الخلاصة (قد يكون رمزًا من حرفين للبلد المستهدف للخلاصة، على سبيل المثال
US أو FR)
- معرّف العرض
لقد جمعت هذه البيانات معًا كـ channel:contentLanguage:feedLabel:offerId، على سبيل المثال، online:en:US:1111111111.
- الرقم التعريفي الخارجي للبائع (الأسواق)
يجب أن تحدّد الأسواق
external_seller_id للعروض التي يتمّ تحميلها إلى
حساب متعدد البائعين. يمثل هذا الحقل بائعًا فرديًا.
قيم external_seller_id حسّاسة لحالة الأحرف، ويجب أن تستوفي المعايير التالية:
- من 1 إلى 50 حرفًا
- أحرف ASCII الرقمية فقط، والشرطة السفلية (_)، والواصلة (-)، والنقطة (.)، والتلدة (~)
ويختلف هذا عن حقل
seller_id الداخلي.
يلخّص الجدول التالي بعض أرقام التعريف التي يمكن ربطها بمنتج:
| السمة |
الوصف |
مثال |
ملاحظات |
offerId |
معرّف يحدّده التاجر لمنتج |
1111111111 |
نوع بيانات السلسلة، وهو معرّف فريد لعرض لأحد المنتجات. |
| رقم تعريف REST |
رقم تعريف تعيّنه Google لمنتج. بالتنسيق channel:contentLanguage:feedLabel:offerId. |
online:en:label:1111111111 |
المعرّف الكامل، بما في ذلك offerId |
productId |
يُستخدم للإشارة إلى رقم تعريف REST في طلبات البيانات من واجهة برمجة التطبيقات. |
online:en:label:1111111111 |
هذا هو معرّف REST لمنتج. |
id |
نفس قيمة REST ID وproductId. |
online:en:label:1111111111 |
تُستخدم داخل نص JSON للمنتج للإشارة إلى productId. |
external_seller_id |
الرقم التعريفي للبائع الذي يتم اختياره في السوق. |
example-Seller1 |
مطلوبة للحسابات المتعددة البائعين. يجب أن يتراوح عدد الأحرف بين 1 و50 حرفًا. تتأثر بحالة الأحرف. يتم قبول الأرقام والأحرف الخاصة _ و- و. و~.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of product data integration with Google.\u003c/p\u003e\n"],["\u003cp\u003eThe beta version of the Merchant API is now available for developers to explore and help shape its future development.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can learn more about the benefits and features of the Merchant API, including how it can enhance integrations, in the official announcement blog post.\u003c/p\u003e\n"],["\u003cp\u003eProducts in the Merchant API are identified using various IDs, such as \u003ccode\u003eofferId\u003c/code\u003e, REST ID, \u003ccode\u003eproductId\u003c/code\u003e, and \u003ccode\u003eexternal_seller_id\u003c/code\u003e, each with specific characteristics and usage contexts.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive table provides detailed explanations and examples of different product ID attributes, outlining their purpose and format.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. Merchants assign an `offerId` to products. Google assigns a unique REST ID in the format `channel:contentLanguage:feedLabel:offerId`; this is also the `productId` and `id` in API calls. Marketplaces assign `external_seller_id` to offers for multi-seller accounts, it has specific format requirements. The Merchant API offers integration improvements; details on this and providing feedback are available via a linked article.\n"],null,["# Product IDs\n\nHere are the different kinds of product IDs in the Content API for Shopping:\n\nOffer ID\n: An `offerId` is a string assigned to a product by a merchant. This ID\n represents an individual product.\n: `offerId` is unique to the set of offers in the Merchant Center database, and\n is usually a numeric sequential number.\n: `offerId` can be an internal SKU number that a merchant assigns to the product.\n\nREST ID\n: A REST ID is the unique identifier for a product assigned by Google.\n: REST ID is the `productId` for REST API calls.\n\n: REST IDs are aggregates with the format `online:en:label:1111111111`. The\n REST ID consists of the following 4 parts, separated by colons:\n\n 1. Channel (\"online\" or \"local\")\n 2. Content Language (using the 2-letter designation, for example `en` or `fr`)\n 3. Feed label (might be the two-letter code for the feed's target country, for example `US` or `FR`)\n 4. Offer ID\n\n: You put this together as `channel:contentLanguage:feedLabel:offerId`, for\n example, `online:en:US:1111111111`.\n\nExternal Seller ID (Marketplaces)\n\n: [Marketplaces](//support.google.com/merchants/answer/6363319)\n must assign an `external_seller_id` to offers uploaded to a multi-seller\n account. This field represents an individual seller.\n\n `external_seller_id` values are case-sensitive, and must meet the following\n criteria:\n\n - 1-50 characters in length\n - Only alphanumeric ASCII characters, and underscore (_), hyphen (-), period (.), and tilde (\\~)\n\n This isn't the same as the internal\n [`seller_id`](/shopping-content/reference/rest/v2.1/accounts) field.\n\nThe following table summarizes some of the IDs that can be associated with a\nproduct:\n\n| Attribute | Description | Example | Notes |\n|----------------------|---------------------------------------------------------------------------------------------------|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `offerId` | An ID assigned to a product by a merchant. | `1111111111` | String data type, unique identifier for a product's offer. |\n| REST ID | An ID assigned to a product by Google. In the format `channel:contentLanguage:feedLabel:offerId`. | `online:en:label:1111111111` | Full ID including `offerId`. |\n| `productId` | Used to refer to the REST ID in API calls. | `online:en:label:1111111111` | This is the REST ID of a product. |\n| `id` | Same value as REST ID and `productId`. | `online:en:label:1111111111` | Used inside JSON body of a product to refer to its `productId`. |\n| `external_seller_id` | A seller ID chosen by the Marketplace. | `example-Seller1` | Required for multi-seller accounts. Must be 1-50 characters. Case-sensitive. Digits, and special characters _, -, ., and \\~ are accepted. |"]]
