rocket
تعرَّف على
Merchant API
الذي يحلّ رسميًا محلّ Content API for Shopping.
add_alert
ملاحظة: سيتم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026.
إعداد البلدان المستهدفة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك إدارة الإعدادات ذات الصلة بميزة "الإعلانات داخل المتجر" باستخدام خدمة
liasettings.
اتّصِل بالرقم liasettings.update لتحديد البلدان التي تخطّط لعرض "إعلانات المنتجات داخل المتجر" فيها. وفي ما يلي مثال لذلك:
PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
{
"accountId" : 67890,
"countrySettings" : [{
"country" : "US"
}]
}
صفحات "لمحة"
إذا كنت تقدّم خدمات في ألمانيا أو النمسا أو سويسرا، عليك أيضًا إرسال صفحة "لمحة". على سبيل المثال، يمكنك إرسال المعلومات التالية للعرض في الولايات المتحدة وألمانيا:
PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
{
"accountId" : 67890,
"countrySettings" : [{
"country" : "US"
},
{
"country" : "DE",
"about" : {
"url" : "https://www.example.com/de/about"
}
}]
}
إلى أن يتم تأكيد عنوان URL هذا، لا يمكن طلب التحقّق من معلومات المستودع. للاطّلاع على حالة تأكيد عنوان URL، استرجِع إعدادات برنامج "الإعلانات داخل المتجر" الخاصة بالحساب من خلال liasettings.get وتحقّق من قيمة حقل الحالة المرتبط:
GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
Response:
200 OK
{
"kind": "content#liaSettings",
"accountId" : 67890,
"countrySettings" : [{
"country" : "US"
},
{
"country" : "DE",
"about" : {
"url" : "https://www.example.com/de/about",
"status" : "pending"
}
}]
}
بعد أن تتغيّر الحالة المرتبطة بعنوان URL إلى active، يتم التحقّق من عنوان URL. إذا كانت الحالة inactive، يعني ذلك أنّ هناك مشاكل يجب حلّها في صفحة "لمحة". بعد حلّ أي مشاكل، يمكنك بدء مراجعة جديدة من خلال تعديل إعدادات "المعلومات المحلية في Google" وإضافة موقع صفحة "لمحة"، سواء كان الموقع الجغرافي هو نفسه أو تغيّر.
صفحات سياسات المنتجات المعروضة للطلب والطلب في المتجر
إذا أردت استخدام ميزة
معروض للطلب (ODO)،
عليك أيضًا إعدادها على مستوى كل بلد:
PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
{
"accountId" : 67890,
"countrySettings" : [{
"country" : "US",
"onDisplayToOrder": {
"shippingCostPolicyUrl" : "https://www.example.com/inStoreOrderPolicy"
}
}]
}
يُرجى العِلم أنّه يجب إثبات ملكية عنوان URL الذي تقدّمه لميزة "معروض للطلب" قبل طلب إثبات صحة معلومات المستودع. تتّبع عملية التحقّق و/أو طلب مراجعة أخرى لعنوان URL الخاص بالسياسة في حال حدوث مشاكل المسار نفسه المتّبع في صفحة "لمحة":
GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
Response:
200 OK
{
"kind": "content#liaSettings",
"accountId" : 67890,
"countrySettings" : [{
"country" : "US",
"onDisplayToOrder": {
"shippingCostPolicyUrl" : "https://www.example.com/inStoreOrderPolicy",
"status" : "pending"
}
}]
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص 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 the platform.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage Local Inventory Ads (LIA) settings, including country targeting and About page submission, using the \u003ccode\u003eliasettings\u003c/code\u003e service.\u003c/p\u003e\n"],["\u003cp\u003eFor countries like Austria, Germany, and Switzerland, an About page submission is required for serving LIAs and must be verified before inventory verification can be requested.\u003c/p\u003e\n"],["\u003cp\u003eOn Display to Order (ODO) feature requires a country-specific setup, including a verified shipping cost policy URL, before inventory verification.\u003c/p\u003e\n"],["\u003cp\u003eVerification status for both About pages and ODO policy URLs can be retrieved using the \u003ccode\u003eliasettings.get\u003c/code\u003e method, and updates or re-reviews can be triggered by modifying the LIA settings.\u003c/p\u003e\n"]]],["The Merchant API's beta version is introduced as the successor to the Content API for Shopping. Using the `liasettings` service, users can manage settings for local inventory ads (LIA). This involves specifying target countries via `liasettings.update` and submitting an \"About page\" URL for Austria, Germany, or Switzerland. The `liasettings.get` method allows checking the URL verification status. The \"on display to order\" (ODO) feature can be enabled per country with a verified policy URL.\n"],null,["# Configure target countries\n\nYou can manage LIA-related settings with the\n[`liasettings`](/shopping-content/reference/rest/v2.1/liasettings) service.\n\nCall [`liasettings.update`](/shopping-content/reference/rest/v2.1/liasettings/update) to specify the countries where you plan to serve local inventory ads. Here's an example: \n\n PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n {\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\"\n }]\n }\n\nAbout pages\n-----------\n\nIf you're serving in Austria, Germany, or Switzerland, you must also [submit an About page](https://support.google.com/merchants/answer/7455784). For example, you might submit the following information to serve in the US and Germany: \n\n PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n {\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\"\n },\n {\n \"country\" : \"DE\",\n \"about\" : {\n \"url\" : \"https://www.example.com/de/about\"\n }\n }]\n }\n\nUntil this URL is verified, inventory verification cannot be requested. To see\nthe URL verification status, retrieve the account's LIA settings via\n[`liasettings.get`](/shopping-content/reference/rest/v2.1/liasettings/get) and check\nthe value of the associated status field: \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n\n Response:\n 200 OK\n {\n \"kind\": \"content#liaSettings\",\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\"\n },\n {\n \"country\" : \"DE\",\n \"about\" : {\n \"url\" : \"https://www.example.com/de/about\",\n \"status\" : \"pending\"\n }\n }]\n }\n\nOnce the status associated with the URL changes to `active`, the URL is\nverified. If the status is `inactive`, then there are issues you must address\nwith your About page. Once you've addressed any issues, you can trigger a new\nreview by either updating your LIA\nsettings with the location of the About page, whether it is the same or has\nchanged.\n\nOn display to order and in-store order policy pages\n---------------------------------------------------\n\nIf you want to use the\n[on display to order](https://support.google.com/merchants/answer/7029575) (ODO)\nfeature, then you should also set that up on a per-country basis: \n\n PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n {\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\",\n \"onDisplayToOrder\": {\n \"shippingCostPolicyUrl\" : \"https://www.example.com/inStoreOrderPolicy\"\n }\n }]\n }\n\nNote that the URL you provide for ODO must be verified *before* you request\ninventory verification. The process for checking verification and/or requesting\nanother review of the policy URL in the case of issues follows the same flow as\nthe About page: \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n\n Response:\n 200 OK\n {\n \"kind\": \"content#liaSettings\",\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\",\n \"onDisplayToOrder\": {\n \"shippingCostPolicyUrl\" : \"https://www.example.com/inStoreOrderPolicy\",\n \"status\" : \"pending\"\n }\n }]\n }"]]
