تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
إضافة بيانات العرض المنظَّمة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح قوائم الأسعار للأنشطة التجارية مشاركة كل ما تقدّمه بسهولة
مباشرةً على "بحث Google" و"خرائط Google". يمكنك إنشاء قوائم أسعار باستخدام
بيانات العروض التقديمية من أجل إضافة بيانات النشاط التجاري إلى بطاقة بياناتك.
من قوائم الطعام إلى الخدمات المتوفّرة، يمكنك السماح للعملاء بالاطّلاع على ما تقدّمه قبل دخولهم إلى المطعم.
في ما يلي مثال على بيانات قائمة الطعام المنظَّمة في "بحث Google":
يمكنك إضافة بيانات قائمة طعام منظَّمة، مثل قائمة طعام، إلى موقع جغرافي باستخدام عنصر
PriceList.
يوضّح طلب JSON التالي كيفية نشر قائمة طعام للإفطار في
موقع جغرافي. تحتوي الاستجابة على مثيل للكائن
Location المعدَّل.
PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}?updateMask=priceLists
{
"priceLists": [
{
"priceListId": "Breakfast",
"labels": [
{
"displayName": "Breakfast",
"description": "Tasty Google Breakfast",
"languageCode": "en"
}
],
"sourceUrl": "http://www.google.com/todays_menu",
"sections": [
{
"sectionId": "entree_menu",
"sectionType":"FOOD",
"labels": [
{
"displayName": "Entrées",
"description": "Breakfast Entrées",
"languageCode": "en"
}
],
"items": [
{
"itemId": "scramble",
"labels": [
{
"displayName": "Big Scramble",
"description": "A delicious scramble filled with Potatoes, Eggs,
Bell Peppers, and Sausage",
"languageCode": "en"
}
],
"price": {
"currencyCode": "USD",
"units": "12",
"nanos": "200000000"
}
},
{
"itemId": "steak_omelette",
"labels": [
{
"displayName": "Steak Omelette",
"description": "Three egg omelette with grilled prime rib,
fire-roasted bell peppers and onions, saut\u00e9ed mushrooms
and melted Swiss cheese",
"languageCode": "en"
}
],
"price": {
"currencyCode": "USD",
"units": "15",
"nanos": "750000000"
}
}
]
}
]
}
]
}
بيانات الخدمة
إذا كان نشاطك التجاري يوفّر خيارات خدمة مختلفة، يمكنك إضافة بيانات خدمات منظَّمة
إلى موقع جغرافي باستخدام العنصر
PriceList.
يوضّح طلب JSON التالي كيفية نشر عرض خدمة في
موقع جغرافي. تحتوي الاستجابة على مثيل للكائن
Location المعدَّل.
PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}?updateMask=priceLists
{
"priceLists": [
{
"priceListId": "Oil Change",
"labels": [
{
"displayName": "Oil Change",
"description": "Caseys Qwik Oil Change",
"languageCode": "en"
}
],
"sourceUrl": "http://www.google.com/todays_services",
"sections": [
{
"sectionId": "oil_services",
"sectionType":”SERVICES”,
"labels": [
{
"displayName": "Services",
"description": "Oil Changes",
"languageCode": "en"
}
],
"items": [
{
"itemId": "20-minute-oil-change",
"labels": [
{
"displayName": "20 Minute Oil Change",
"description": "Quick oil change and filter service.",
"languageCode": "en"
}
],
"price": {
"currencyCode": "USD",
"units": "30",
"nanos": "200000000"
}
},
{
"itemId": "full_service_oil_change",
"labels": [
{
"displayName": "Full Service Oil Change",
"description": "Quick oil change, filter service, and brake inspection.",
"languageCode": "en"
}
],
"price": {
"currencyCode": "USD",
"units": "45",
"nanos": "750000000"
}
}
]
}
]
}
]
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003cstrong\u003ePrice lists are outdated\u003c/strong\u003e and replaced by Food Menus and Services for sharing business offerings on Google Search and Maps.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses can use structured offering data, like price lists, to \u003cstrong\u003edisplay food and service offerings directly on their Google Business Profile\u003c/strong\u003e.\u003c/p\u003e\n"],["\u003cp\u003ePrice lists utilize the \u003ccode\u003ePriceList\u003c/code\u003e object and structured data to showcase menus and service options with details like descriptions and pricing.\u003c/p\u003e\n"],["\u003cp\u003eAlthough deprecated, price lists previously allowed businesses to \u003cstrong\u003eadd detailed menu and service information using JSON requests\u003c/strong\u003e.\u003c/p\u003e\n"]]],["Businesses can share their offerings on Google Search and Maps using structured data. Price lists, though deprecated, allowed adding business data like food menus or services via the `PriceList` object. This involved sending a PATCH request to update location data. The request included details like `priceListId`, `labels`, `sourceUrl`, `sections`, and individual `items` with prices and descriptions. Examples for a breakfast menu and an oil change service were provided, showcasing structured data formats. The new methods are FoodMenus and Services.\n"],null,["# Add structured offering data\n\n\u003cbr /\u003e\n\n| **Important:** priceLists are deprecated in favor of [FoodMenus](/my-business/content/update-food-menus) and [Services](/my-business/content/services).\n\nPrice lists allow businesses to easily share everything they have to offer\ndirectly on Google Search and Maps. You can create price lists with the use of\nstructured offering data, which allows you to add business data to your listing.\nFrom food menus to service offerings, let your customers see what you have to\noffer before they walk in the door.\n\nThe following is an example of structured menu data in Google Search:\n\nMenu data\n---------\n\nYou can add structured menu data, like a food menu, to a location with the use\nof the [PriceList](/my-business/reference/rest/v4/accounts.locations#pricelist)\nobject.\n\nThe following JSON request shows how to publish a breakfast menu to a\nlocation. The response contains an instance of the updated\n`Location` object.\nHTTP \n\n```scdoc\nPATCH\nhttps://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}?updateMask=priceLists\n {\n \"priceLists\": [\n {\n \"priceListId\": \"Breakfast\",\n \"labels\": [\n {\n \"displayName\": \"Breakfast\",\n \"description\": \"Tasty Google Breakfast\",\n \"languageCode\": \"en\"\n }\n ],\n \"sourceUrl\": \"http://www.google.com/todays_menu\",\n \"sections\": [\n {\n \"sectionId\": \"entree_menu\",\n \"sectionType\":\"FOOD\",\n \"labels\": [\n {\n \"displayName\": \"Entrées\",\n \"description\": \"Breakfast Entrées\",\n \"languageCode\": \"en\"\n }\n ],\n \"items\": [\n {\n \"itemId\": \"scramble\",\n \"labels\": [\n {\n \"displayName\": \"Big Scramble\",\n \"description\": \"A delicious scramble filled with Potatoes, Eggs, \n Bell Peppers, and Sausage\",\n \"languageCode\": \"en\"\n }\n ],\n \"price\": {\n \"currencyCode\": \"USD\",\n \"units\": \"12\",\n \"nanos\": \"200000000\"\n }\n },\n {\n \"itemId\": \"steak_omelette\",\n \"labels\": [\n {\n \"displayName\": \"Steak Omelette\",\n \"description\": \"Three egg omelette with grilled prime rib, \n fire-roasted bell peppers and onions, saut\\u00e9ed mushrooms\n and melted Swiss cheese\",\n \"languageCode\": \"en\"\n }\n ],\n \"price\": {\n \"currencyCode\": \"USD\",\n \"units\": \"15\",\n \"nanos\": \"750000000\"\n }\n }\n ]\n }\n ]\n }\n ]\n}\n```\n\nService data\n------------\n\nIf your business offers different service options, you can add structured\nservices data to a location with the use of the\n[PriceList](/my-business/reference/rest/v4/accounts.locations#pricelist) object.\n\nThe following JSON request shows how to publish a service offering to a\nlocation. The response contains an instance of the updated\n`Location` object.\nHTTP \n\n```scdoc\nPATCH\nhttps://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}?updateMask=priceLists\n {\n \"priceLists\": [\n {\n \"priceListId\": \"Oil Change\",\n \"labels\": [\n {\n \"displayName\": \"Oil Change\",\n \"description\": \"Caseys Qwik Oil Change\",\n \"languageCode\": \"en\"\n }\n ],\n \"sourceUrl\": \"http://www.google.com/todays_services\",\n \"sections\": [\n {\n \"sectionId\": \"oil_services\",\n \"sectionType\":”SERVICES”,\n \"labels\": [\n {\n \"displayName\": \"Services\",\n \"description\": \"Oil Changes\",\n \"languageCode\": \"en\"\n }\n ],\n \"items\": [\n {\n \"itemId\": \"20-minute-oil-change\",\n \"labels\": [\n {\n \"displayName\": \"20 Minute Oil Change\",\n \"description\": \"Quick oil change and filter service.\",\n \"languageCode\": \"en\"\n }\n ],\n \"price\": {\n \"currencyCode\": \"USD\",\n \"units\": \"30\",\n \"nanos\": \"200000000\"\n }\n },\n {\n \"itemId\": \"full_service_oil_change\",\n \"labels\": [\n {\n \"displayName\": \"Full Service Oil Change\",\n \"description\": \"Quick oil change, filter service, and brake inspection.\",\n \"languageCode\": \"en\"\n }\n ],\n \"price\": {\n \"currencyCode\": \"USD\",\n \"units\": \"45\",\n \"nanos\": \"750000000\"\n }\n }\n ]\n }\n ]\n }\n ]\n}\n```"]]
