‏ملحق Meta للأعمال‏

المرجع

يوضح هذا الدليل المرجعي رسائل الأخطاء ويحدد حقول كائن API ملحق Meta للأعمال وبنية الأنواع المختلفة.

كائنات وأنواع API ملحق Meta للأعمال

استخدم هذا الجدول المرجعي كملخص يحدد الكائنات والأنواع المرتبطة في ملحق Meta للأعمال.

الكائن الوصف

extras

يحدد التدفقات الخاصة بملحق Meta للأعمال، مثل الميزات والإعدادات المستخدمة التي يتم تكوينها للبائع. راجع الحقول المدعومة.

setup

يحدد إعدادات تواجد المستخدم النهائي على Meta. راجع الحقول المدعومة.

business_config

يحدد إعدادات النشاط التجاري المطلوب تكوينها للمستخدم النهائي. يتضمن ذلك Messenger والكتالوجات والمزيد. راجع الحقول المدعومة. يتضمن كل حقل "نوعًا" محددًا:

الإضافات

استخدم هذا الكائن لتحديد التدفقات الخاصة بملحق Meta للأعمال، مثل الميزات والإعدادات المستخدمة التي يتم تكوينها للبائع.

الحقل الوصف

setup

النوع: setup (إعداد)

مطلوب.

إعداد Meta الخاص بالبائع، مثل المعرف الفريد الخاص به (external_business_id) أو عملة الكتالوج الخاصة به (currency). راجع تفاصيل الكائن setup.

business_config

النوع: business_config

مطلوب.

كائن التكوين الذي يستخدمه ملحق Meta للأعمال لتكوين سير عمل ملحق Meta للأعمال. راجع تفاصيل الكائن business_config.

repeat

النوع: boolean (قيمة منطقية)

مطلوب.

يمكنك تعيين هذه القيمة على false.

الإعداد

يمكنك استخدام هذا الكائن لتحديد إعدادات وجود المستخدم النهائي على Meta.

الحقل الوصف

external_business_id

النوع: string (سلسلة)

مطلوب.

معرف النشاط التجاري الفريد المطلوب لتمثيل النشاط التجاري للعميل. نستخدم ذلك كمعرف فريد. على سبيل المثال، إذا كانت شركة البائع تُسمى "Fubar"، فقد يكون "fubar-123" هو معرف external_business_id.

timezone

النوع: string (سلسلة)

مطلوب.

المنطقة الزمنية التي يتواجد فيها النشاط التجاري. راجع قيم المنطقة الزمنية المحتملة.

currency

النوع: string (سلسلة)

مطلوب.

رمز العملة بتنسيق ISO مكونًا من ثلاثة أحرف للعملة الافتراضية لعناصر كتالوج النشاط التجاري. راجع رموز العملة المدعومة.

business_vertical

النوع: Enum (تعداد) {'ECOMMERCE', 'APPOINTMENTS', 'RESERVATIONS', 'FOOD_AND_DRINK', 'CREATIVE', 'ADS_TARGETING', 'LEAD_ADS', 'MEASUREMENT_AND_OPTIMIZATION'}

مطلوب.

المجال المرتبط بالنشاط التجاري. راجع قائمة المجالات.

merchant_settings_id

النوع: string (سلسلة)

اختياري.

يتم استخدامه عند الترقية من الإصدار 1 من ملحق Meta للأعمال. تواصل مع ممثل Meta إذا كنت تحاول الترحيل من الإصدار 1 إلى الإصدار 2.

domain

النوع: string (سلسلة)

مطلوب لقناتي COMMERCE وCOMMERCE_OFFSITE. اختياري للقنوات الأخرى.

النطاق المستخدم للموافقة اليدوية في Instagram. مثال: 'https://exampleshop.partnersite.com'

channel

النوع: enum (تعداد)

اختياري.

قناة توفر طريقة للشريك للتعبير عن نيته للمستخدم فيما يتعلق بالميزات التي تتطلب خطوات أو قيودًا إضافية: COMMERCE وCOMMERCE_OFFSITE.

  • ADS_MINIMAL — دفق يسمح للبائعين بالتفاعل مع المتابعين وإنشاء الجماهير والترويج للمبيعات.

  • AR_COMMERCE — دفق يسمح للبائعين باستخدام ميزات الواقع المعزَّز للمساعدة في التفاعل مع المتابعين وإنشاء الجماهير.

  • CATALOG_ADS — دفق يسمح للبائعين بمزامنة منتجات وخدمات الكتالوج والترويج لها.

  • CHECKBOX_PLUGIN — دفق يسمح للبائعين بإضافة مربع اختيار إلى مواقع الويب والذي يمكن للعملاء استخدامه للاشتراك لتلقي تحديثات حول المواعيد.

  • CHECKBOX_PLUGIN_MARKETING — دفق يسمح للبائعين بإضافة مربع اختيار يمكن للعملاء استخدامه للاشتراك في تلقي الرسائل التسويقية. ويسمح للبائع بمزامنة بيانات الطلب لزيادة فعالية الجهود التسويقية.

  • COMMERCE — يمثل دفقًا يسمح للبائعين بإنشاء حساب معاملات تجارية من خلال متجر الصفحة وقناة التسوق على Instagram من خلال عمليات إتمام الشراء داخل الموقع أو خارجه.

  • COMMERCE_OFFSITE — دفق يسمح للبائعين بإنشاء حساب معاملات تجارية بمتجر فيسبوك خارج الموقع والتسوق على Instagram خارج الموقع.

  • CONVERSIONS_API — دفق يسمح للبائعين بإرسال أحداث البيكسل وواجهة API التحويلات، مع استبعاد كتالوج فيسبوك كأصل. ويوصى به بشدة فقط للشركاء الذين لديهم إمكانات استضافة موقع الويب، ولكن ليس لديهم إمكانات الكتالوج.

  • CONVERSIONS_API_MINIMAL — دفق يسمح للبائعين بإرسال أحداث البيكسل وواجهة API التحويلات الخاصة بـ Meta مع عدد أقل من الأصول مقارنةً بـ CONVERSIONS_API.

  • CREATIVE — دفق يسمح للبائعين بإنشاء التصميمات على منصات الشركاء ومشاركتها مرة أخرى في مدير الأعمال لدى البائع.

  • CREATIVE_WITH_ASSETS — دفق يسمح للبائعين بالترويج للمنتجات أو الخدمات من خلال مزامنة الكتالوج الخاص بهم.

  • CUSTOM_AUDIENCE — دفق يسمح للبائعين بتحسين استهداف الإعلانات من خلال شريحة مخصصة أو زوار منصة معينة أو أشخاص مشابهين لهم.

  • CUSTOMER_DATA — دفق يسمح للبائعين بتشجيع العملاء على التفاعل والتواصل مع الأشخاص الذين قد يهتمون بنشاطهم التجاري.

  • DEFAULT — دفق يسمح للبائعين باستخدام ميزات التسويق للمساعدة في تشجيع المتابعين على التفاعل وإنشاء الجماهير والترويج للمبيعات.

  • FB_SERVICES — دفق يسمح للبائعين بالوصول إلى عملاء جدد من خلال تقديم منتجات أو خدمات مباشرةً على فيسبوك.

  • FEED - دفق يسمح للبائعين بالتجزئة بمزامنة الكتالوج الخاص بهم، باستثناء بيكسل Meta كأصل. ويوصى به فقط للشركاء الذين لديهم إمكانات قائمة المنتجات/الكتالوج وليس لديهم إمكانية استضافة موقع الويب.

  • LEAD_ADS — دفق يسمح للبائعين بتشغيل إعلانات تجميع بيانات العملاء المحتملين لزيادة شريحة الجماهير والعثور على عملاء جدد.

  • MESSENGER_CHAT — دفق يسمح للبائعين بالتواصل بشكل أكثر استمرارًا وفعالية مع العملاء باستخدام دردشة Messenger.

  • MESSENGER_MARKETING — دفق يسمح للبائعين بإضافة مربع اختيار يمكن للعملاء استخدامه للاشتراك في تلقي الرسائل التسويقية. ويسمح للبائعين بمزامنة بيانات الطلب لزيادة فعالية الجهود التسويقية.

  • MARKETPLACE - دفق يسمح للبائعين بإنشاء/تحديد أصول الأنشطة التجارية، مع استثناء خطوة إنشاء كتالوج فيسبوك. موصى به فقط للشركاء الذين لا يطلبون من البائعين إنشاء كتالوج ويعتمدون بدلاً من ذلك على مشاركة شريحة الكتالوج (على سبيل المثال: حالة استخدام الإعلانات التعاونية). يتطلب هذا الدفق الحصول على موافقة إضافية قبل إمكانية استخدامه. يُرجى الاتصال بممثل Meta للحصول على الموافقة.

  • PARTNER_SIGNAL_INTEGRATION - دفق يسمح للبائعين بالحصول على المزيد من المعلومات في تطبيقات التجارة الإلكترونية التابعة لجهة خارجية من أجل تحسين قرارات التسويق باستخدام الرؤى التفصيلية للإعلانات.

  • SIGNALS - دفق يسمح للبائعين بإرسال أحداث البيكسل وواجهة API التحويلات الخاصة بـ Meta، مع استبعاد كتالوج فيسبوك كأصل. ويوصى به فقط للشركاء الذين لديهم إمكانات استضافة موقع الويب، وليس لديهم إمكانات الكتالوج.

  • IG_CREATORS_AS_SELLERS - دفق يسمح للبائعين بإعداد أدوات تمكين السلع، مما يسمح لمنشئي المحتوى ببيع العناصر المصممة والمصنعة على مواقع الويب الخارجية.

يجب على الشركاء طلب الحصول على الإذن instagram_basic لكل عمليات التجارة (COMMERCE وCOMMERCE_OFFSITE). الإذن instagram_basic مطلوب للتطبيق لدعم سياسة وصول الإعداد/البائع على Instagram. يتطلب هذا الإذن الخضوع لعملية مراجعة التطبيقات.

business_manager_id

النوع: string (سلسلة)

اختياري.

يمثل معرف مدير الأعمال لمدير الأعمال الحالي الخاص بالمستخدم الذي يمكن للشريك إرساله بغرض تحديده مسبقًا من جانب المستخدم في دفق الإعداد.

ad_account_id

النوع: string (سلسلة)

اختياري.

معرف الحساب الإعلاني لحساب المستخدم الإعلاني الحالي الذي يمكن للشريك إرساله ليتم تحديده مسبقًا من جانب المستخدم في دفق الإعداد.

page_id

النوع: string (سلسلة)

اختياري.

معرف الصفحة لصفحة فيسبوك الخاصة بالعميل الحالي الذي يمكن للشريك إرساله ليتم تحديده مسبقًا من جانب المستخدم في دفق الإعداد.

ig_profile_id

النوع: string (سلسلة)

اختياري.

معرف ملف النشاط التجاري على Instagram لملف النشاط التجاري على Instagram الخاص بالعميل الحالي الذي يمكن للشريك إرساله ليتم تحديده مسبقًا من جانب المستخدم في دفق الإعداد.

pixel_id

النوع: string (سلسلة)

اختياري.

معرف البيكسل لبيكسل Meta للمستخدم الحالي، والذي يمكن للشريك إرساله ليتم تحديده مسبقًا من جانب المستخدم في دفق الإعداد.

catalog_id

النوع: string (سلسلة)

اختياري.

معرف البيكسل لبيكسل المستخدم الحالي الذي يمكن للشريك إرساله ليتم تحديده مسبقًا من جانب المستخدم في دفق الإعداد.

connection_name

النوع: string (سلسلة)

اختياري.

يتم إدخال اسم الاتصال عندما لا يكون اسم التطبيق وexternal_business_id كافيين.

flow_config

النوع: FBEFlowConfigData

اختياري.

يمكن استخدام هذا الحقل لتحديد الإعدادات في قناة IG_CREATORS_AS_SELLERS.

intents

النوع: enum (تعداد)

اختياري.

يمكن استخدام هذا الحقل لتعيين النشاط التجاري بشكل افتراضي إلى مجموعة معينة من الميزات المطلوب تثبيتها أولاً. تتضمن المعلمات:

ADS AR_COMMERCE CATALOG_ADS CHECKBOX_PLUGIN CHECKBOX_PLUGIN_MARKETING COLLABORATIVE_ADS CONVERSIONS_API CREATIVE CREATIVE_WITH_ASSETS CUSTOM_AUDIENCE CUSTOMER_DATA FB_SERVICES FB_SHOP IG_CREATORS_AS_SELLERS IG_SERVICES IG_SHOP LEAD_ADS MESSENGER_CHAT MESSENGER_MARKETING

use_minimal_onboarding

النوع: enum (تعداد)

اختياري.

يمكن استخدام هذا الحقل لاحتيار عرض تجربة الإعداد الأدنى للنشاط التجاري أم لا (على سبيل المثال قائمة الميزة).

يتم تجاهل الإدخال في هذه الحقول إذا لم يتمتع المستخدم بصلاحية وصول المسؤول أو إذا لم يكن الإدخال مؤهلاً للتثبيت مع الأصول الأخرى:

  • business_manager_id
  • ad_account_id
  • page_id
  • ig_profile_id
  • pixel_id
  • catalog_id

FBEFlowConfigData

استخدم الحقل FBEFlowConfigData لتحديد الإعدادات في قناة IG_CREATORS_AS_SELLERS.

الحقل الوصف

num_catalog_items

النوع: integer (عدد صحيح)

اختياري.

عدد العناصر الموجودة في الكتالوج التي يجب مشاركتها/إنشاءها من خلال Meta.

intents

النوع: enum (تعداد)

اختياري.

يمكن استخدام هذا الحقل لتعيين النشاط التجاري بشكل افتراضي إلى مجموعة معينة من الميزات المطلوب تثبيتها أولاً. تتضمن المعلمات:

ADS AR_COMMERCE CATALOG_ADS CHECKBOX_PLUGIN CHECKBOX_PLUGIN_MARKETING COLLABORATIVE_ADS CONVERSIONS_API CREATIVE CREATIVE_WITH_ASSETS CUSTOM_AUDIENCE CUSTOMER_DATA FB_SERVICES FB_SHOP IG_CREATORS_AS_SELLERS IG_SERVICES IG_SHOP LEAD_ADS MESSENGER_CHAT MESSENGER_MARKETING

use_minimal_onboarding

النوع: enum (تعداد)

اختياري.

يمكن استخدام هذا الحقل لاحتيار عرض تجربة الإعداد الأدنى للنشاط التجاري أم لا (على سبيل المثال قائمة الميزة).

business_config

استخدم الكائن business_config لتكوين إعدادات النشاط التجاري للمستخدم النهائي. يتضمن ذلك Messenger والمزيد. يتضمن كل حقل "نوعًا" مرتبطًا بالجداول المعنية أدناه.

الحقول المدعومة لـ business_config

الحقل الوصف

business

النوع: FBEBusinessPropertiesConfigData

مطلوب.

معلومات للنشاط التجاري الخاص بالمستخدم النهائي.

messenger_chat

النوع: FBEMessengerChatConfigData

اختياري.

ميزات دردشة Messenger على صفحة فيسبوك للمستخدم النهائي، مثل enabled وdomains.

catalog_feed_scheduled

النوع: FBECatalogFeedConfigData

اختياري.

يحدد ما إذا كان يجب على ملحق Meta للأعمال استخدام نهج قائمة البيانات والذي يجلب عناصر الكتالوج من feed_url.

page_cta

النوع: FBEPageCtaConfigData

اختياري.

زر الدعوة لاتخاذ إجراء (CTA) لصفحة المستخدم النهائي، مثل cta_button_text وcta_button_url وما إلى ذلك.

page_card

النوع: FBEPageCardConfigData

اختياري.

بطاقة الخدمات "المميزة" على صفحة ما، مثل cta_button_text وformat وما إلى ذلك. تنطبق فقط على المجال APPOINTMENTS.

ig_cta

النوع: FBEIGCtaConfigData

اختياري.

الميزات المتوفرة لميزة زر الدعوة لاتخاذ إجراء في Instagram، مثل enabled وcta_button_text وcta_button_url وما إلى ذلك.

messenger_menu

النوع: FBEMessengerMenuConfigData

اختياري.

الميزات المتوفرة لميزة القائمة الثابتة في Messenger، مثل cta_button-text وcta_button_url.

thread_intent

النوع: FBEThreadIntentConfigData

اختياري.

الميزات المطلوب تحديدها إذا تم تمكين ميزة نية سلسلة الرسائل في Messenger. تنطبق فقط على المجال APPOINTMENTS.

FBEBusinessPropertiesConfigData

استخدم الكائن FBEBusinessPropertiesConfigData لتكوين اسم النشاط التجاري.

الحقل الوصف

name

النوع: string (سلسلة)

مطلوب.

اسم النشاط التجاري.

FBECatalogFeedConfigData

استخدم الكائن FBECatalogFeedConfigData لتكوين قائمة منتجات الكتالوج أو أسلوب "السحب" لتحديث الكتالوج. أسلوب السحب لا يوصى به عادةً لأنه يؤدي إلى جلب مخزونات قديمة حتى موعد إجراء عمليات السحب اللاحقة، ولكنه يُعد مفيدًا للأنشطة التجارية الصغيرة ذاتية الاستضافة التي تمتلك ملف مخزون يمكن الوصول إليه بشكل عام.

الحقل الوصف

enabled

النوع: boolean (قيمة منطقية)

مطلوب.

يمكن التمييز لتمكين الميزة أو تعطيلها.

feed_url

النوع: string (سلسلة)

مطلوب.

عنوان URL الخاص بملف تتم استضافته بشكل عام ويحتوي على مخزون النشاط التجاري (يجب أن يكون بتنسيق CSV أو TSV أو XML).

FBEPageCtaConfigData

استخدم الكائن FBEPageCtaConfigData لتكوين زر الدعوة لاتخاذ إجراء الخاص بالصفحة. هذا يشير إلى النص وعنوان url والوصف الفعليين.

الحقل الوصف

enabled

النوع: boolean (قيمة منطقية)

مطلوب.

يمكن التمييز لتمكين الميزة أو تعطيلها.

cta_button_text

النوع: enum (تعداد) {'احجز الآن' | 'اشتري الآن' | 'احجز' | 'اطلب الطعام'}

مطلوب.

النص المطلوب عرضه في زر الدعوة لاتخاذ إجراء (CTA) لصفحة فيسبوك لدى النشاط التجاري.

cta_button_url

النوع: string (سلسلة)

مطلوب.

عنوان URL الذي يتم فتحه عند الضغط على زر الدعوة لاتخاذ إجراء (CTA) في صفحة فيسبوك التابعة للنشاط التجاري.

below_button_text

النوع: string (سلسلة)

مطلوب.

النص الفرعي المعروض ضمن زر الدعوى لاتخاذ إجراء في صفحة فيسبوك التابعة للنشاط التجاري. تُستخدم بشكل عام لإسناد الشريك، إذا رغبت في ذلك؛ على سبيل المثال، "برعاية الشريك".

FBEIGCtaConfigData

استخدم الكائن FBEIGCtaConfigData لتكوين زر الدعوة لاتخاذ إجراء في حساب Instagram التابع للنشاط التجاري.

الحقل الوصف

enabled

النوع: boolean (قيمة منطقية)

مطلوب.

يمكن التمييز لتمكين الميزة أو تعطيلها.

cta_button_text

النوع: enum (تعداد) {'احجز الآن' | 'اشتري الآن' | 'احجز' | 'اطلب الطعام'}

مطلوب.

النص المطلوب عرضه في زر الدعوة لاتخاذ إجراء ضمن الملف الشخصي في حساب Instagram التابع للنشاط التجاري.

cta_button_url

النوع: string (سلسلة)

مطلوب.

عنوان URL الذي يتم فتحه عند الضغط على زر الدعوة لاتخاذ إجراء ضمن الملف الشخصي في حساب Instagram التابع للنشاط التجاري.

FBEMessengerMenuConfigData

استخدم الكائن FBEMessengerMenuConfigData لتكوين زر الدعوة لاتخاذ إجراء في قائمة messenger التابعة للنشاط التجاري.

الحقل الوصف

enabled

النوع: boolean (قيمة منطقية)

مطلوب.

يمكن التمييز لتمكين الميزة أو تعطيلها.

cta_button_text

النوع: enum (تعداد) {'احجز الآن' | 'اشتري الآن' | 'احجز' | 'اطلب الطعام'}

مطلوب.

النص المطلوب عرضه في زر القائمة الثابتة ضمن Messenger عندما يراسل المستخدم النشاط التجاري.

cta_button_url

النوع: string (سلسلة)

مطلوب.

عنوان URL الذي يتم فتحه عند الضغط على زر القائمة الثابتة في Messenger.

FBEPageCardConfigData

استخدم الكائن FBEPageCardConfigData لتمكين ميزة بطاقة الصفحة، والتي تعرض الخدمات المميزة للأنشطة التجارية. موصى به للمجال APPOINTMENTS.

الحقل الوصف

enabled

النوع: boolean (قيمة منطقية)

مطلوب.

يمكن التمييز لتمكين الميزة أو تعطيلها.

see_all_text

النوع: enum (تعداد) {'شاهد الكل'}

مطلوب.

النص المطلوب عرضه في اللوحة السفلية ضمن بطاقة صفحة الخدمات المميزة التي تؤدي إلى الانتقال إلى عنوان URL خارجي. لا يتم دعم سوى "عرض الكل" في الوقت الحالي.

see_all_url

النوع: string (سلسلة)

مطلوب.

عنوان URL الذي يتم فتحه عند الضغط على اللوحة السفلية ضمن بطاقة صفحة الخدمات المميزة.

cta_button_text

النوع: enum (تعداد) {'احجز'}

مطلوب.

النص المطلوب عرضه في زر الدعوة لاتخاذ إجراء لكل عنصر معروض. لا يتم دعم سوى "حجز" في الوقت الحالي.

FBEMessengerChatConfigData

استخدم الكائن FBEMessengerChatConfigData لتكوين خيارات الدردشة في messenger لدى الصفحة.

الحقل الوصف

enabled

النوع: boolean (قيمة منطقية)

مطلوب.

يمكن التمييز لتمكين الميزة أو تعطيلها.

domains

النوع: vec<string>

مطلوب.

قائمة بعناوين URL الصالحة التي يمكنها عرض المكون الإضافي "دردشة العملاء". يجب أن يكون كل عنوان URL عبارة عن عنوان URL صالح، بما في ذلك معرف البروتوكول. مثال: https://

مثال: https://jaspers-market.com

FBEThreadIntentConfigData

استخدم الكائن FBEThreadIntentConfigData لتكوين استجابة messenger لنية المستخدم. موصى به للمجال APPOINTMENTS.

الحقل الوصف

enabled

النوع: boolean (قيمة منطقية)

مطلوب.

يمكن التمييز لتمكين الميزة أو تعطيلها.

cta_button_url

النوع: string (سلسلة)

مطلوب.

عنوان URL الذي يرسله اقتراح Messenger للمستخدم، ومن خلاله يمكن للمستخدم حجز موعد مع النشاط التجاري.

تنسيق طلب تجميع المواعيد (الخدمات)

المعلمة الوصف

allow_upsert

النوع: boolean (قيمة منطقية)

عندما يكون allow_upsert بالقيمة false، لن تكتمل طلبات التحديث للعناصر غير الموجودة في الكتالوج. بخلاف ذلك، يتم إنشاء عناصر جديدة.

item_type

النوع: string (سلسلة)

نوع العناصر الموجودة في الطلب (TRANSACTABLE_ITEMS)

requests

النوع: object (كائن)

كائن JSON يحتوي على كل الطلبات.

requests.data

النوع: object (كائن)

كائن JSON يحتوي على الحقول والقيم لعنصر ما.

  • عندما يكون الأسلوب CREATE، يجب أن يحتوي هذا الكائن على كل الحقول المطلوبة.
  • عندما يكون الأسلوب UPDATE، يمكنه أن يحتوي على كل الحقول.

requests.method

النوع: string (سلسلة)

CREATE وUPDATE وDELETE

requests.retailer_id

النوع: string (سلسلة)

id الذي قدمه المعلن لعنصر ما؛ ليس معرف FBID.

الحقول المدعومة في requests.data للخدمات

راجع الحقول المدعومة لكتالوج المواعيد (الخدمات)

الحقول المدعومة لكتالوج المواعيد (الخدمات)

الحقل والنوعالوصف

item_id

النوع: string (سلسلة)

مطلوب.

المعرف التابع لجهة خارجية للخدمة.

title

النوع: string (سلسلة)

مطلوب.

عنوان الخدمة. الحد الأقصى للأحرف: 200

description

النوع: string (سلسلة)

مطلوب.

الوصف القصير للخدمة. الحد الأقصى للطول: 9999

price_type

النوع: enum (تعداد)

نوع سعر الخدمة:

  • VALUE - يوجد سعر محدد لهذه الخدمة.
  • MINIMUM - يوجد حد أدنى لسعر هذه الخدمة.
  • TIME_DEPENDENT - لا يوجد سعر محدد (هذا للتسعير مقابل كل ساعة أو كل دقيقة).
  • FREE - الخدمة مجانية.
  • VARIES - يتم تحديد السعر ديناميكيًا خلال وقت الخدمة. إذا كان القيمة VALUE أو MINIMUM، فحينها يصبح price مطلوبًا.

price

النوع: string (سلسلة)

اختياري عندما يكون price_type بالقيمة TIME_DEPENDENT أو FREE أو VARIES.

تكلفة الخدمة. يجب تحديد القيمة برمز العملة ISO-4217-3.

المثال: 99.99 USD

duration_type

النوع: enum (تعداد)

إذا كانت القيمة FIXED أو MINIMUM، فحينها يصبح duration_time مطلوبًا.

نوع مدة الخدمة:

  • FIXED - توجد مدة محددة للخدمة.
  • MINIMUM - الحد لأدنى للمدة مطلوب، ولكن يمكن للحجز أن يمتد لبعد ذلك الحد.
  • VARIES - لا توجد مدة محددة (أو حد أدنى للمدة).

duration_time

النوع: int (عدد صحيح)

اختياري عندما يكون duration_type بالقيمة VARIES.

مدة الخدمة.

url

النوع: string (سلسلة)

مطلوب.

رابط موقع ويب النشاط التجاري حيث يمكن للشخص حجز الخدمة.

order_index

النوع: integer (عدد صحيح)

اختياري.

الفهرس المستخدم للحفاظ على الترتيب بشكل اختياري بالنسبة إلى الخدمات الأخرى في الكتالوج المحتوي.

image

النوع: object (كائن)

اختياري.

أقصى عدد للعناصر: 20

بيانات الصورة لهذه الخدمة.

يمكنك وضع حتى 20 صورة للخدمة. كما تحتوي كل صورة على حقلين وهما: url وtag. يمكن أن تكون لديك عدة علامات مرتبطة بصورة واحدة. يجب وضع صورة واحدة على الأقل. يمكن أن يصل حجم كل صورة إلى 4 ميجابايت كحد أقصى.

راجع معلمات كائن الصورة

معلمات كائن الصورة

اسم الحقل والنوعالوصف

url

النوع: string (سلسلة)

مطلوب.

عنوان URL لصورة الخدمة.

يجب أن تكون كل الصور بتنسيق JPG أو GIF أو PNG.

tag

النوع: string (سلسلة)

اختياري.

سلسلة تمثل محتوى الخدمة. يمكن وضع عدة علامات مرتبطة بالصورة.

المناطق الزمنية لمطوّري النشاط التجاري

يحتوي الجدول التالي على القيم المقبولة للحقل timezone.

Africa/Abidjan

Africa/Accra

Africa/Addis_Ababa

Africa/Algiers

Africa/Asmara

Africa/Asmera

Africa/Bamako

Africa/Bangui

Africa/Banjul

Africa/Bissau

Africa/Blantyre

Africa/Brazzaville

Africa/Bujumbura

Africa/Cairo

Africa/Casablanca

Africa/Ceuta

Africa/Conakry

Africa/Dakar

Africa/Dar_es_Salaam

Africa/Djibouti

Africa/Douala

Africa/El_Aaiun

Africa/Freetown

Africa/Gaborone

Africa/Harare

Africa/Johannesburg

Africa/Juba

Africa/Kampala

Africa/Khartoum

Africa/Kigali

Africa/Kinshasa

Africa/Lagos

Africa/Libreville

Africa/Lome

Africa/Luanda

Africa/Lubumbashi

Africa/Lusaka

Africa/Malabo

Africa/Maputo

Africa/Maseru

Africa/Mbabane

Africa/Mogadishu

Africa/Monrovia

Africa/Nairobi

Africa/Ndjamena

Africa/Niamey

Africa/Nouakchott

Africa/Ouagadougou

Africa/Porto-Novo

Africa/Sao_Tome

Africa/Timbuktu

Africa/Tripoli

Africa/Tunis

Africa/Windhoek

America/Adak

America/Anchorage

America/Anguilla

America/Antigua

America/Araguaina

America/Argentina/Buenos_Aires

America/Argentina/Catamarca

America/Argentina/ComodRivadavia

America/Argentina/Cordoba

America/Argentina/Jujuy

America/Argentina/La_Rioja

America/Argentina/Mendoza

America/Argentina/Rio_Gallegos

America/Argentina/Salta

America/Argentina/San_Juan

America/Argentina/San_Luis

America/Argentina/Tucuman

America/Argentina/Ushuaia

America/Aruba

America/Asuncion

America/Atikokan

America/Atka

America/Bahia

America/Bahia_Banderas

America/Barbados

America/Belem

America/Belize

America/Blanc-Sablon

America/Boa_Vista

America/Bogota

America/Boise

America/Buenos_Aires

America/Cambridge_Bay

America/Campo_Grande

America/Cancun

America/Caracas

America/Catamarca

America/Cayenne

America/Cayman

America/Chicago

America/Chihuahua

America/Coral_Harbour

America/Cordoba

America/Costa_Rica

America/Creston

America/Cuiaba

America/Curacao

America/Danmarkshavn

America/Dawson

America/Dawson_Creek

America/Denver

America/Detroit

America/Dominica

America/Edmonton

America/Eirunepe

America/El_Salvador

America/Ensenada

America/Fort_Nelson

America/Fort_Wayne

America/Fortaleza

America/Glace_Bay

America/Godthab

America/Goose_Bay

America/Grand_Turk

America/Grenada

America/Guadeloupe

America/Guatemala

America/Guayaquil

America/Guyana

America/Halifax

America/Havana

America/Hermosillo

America/Indiana/Indianapolis

America/Indiana/Knox

America/Indiana/Marengo

America/Indiana/Petersburg

America/Indiana/Tell_City

America/Indiana/Vevay

America/Indiana/Vincennes

America/Indiana/Winamac

America/Indianapolis

America/Inuvik

America/Iqaluit

America/Jamaica

America/Jujuy

America/Juneau

America/Kentucky/Louisville

America/Kentucky/Monticello

America/Knox_IN

America/Kralendijk

America/La_Paz

America/Lima

America/Los_Angeles

America/Louisville

America/Lower_Princes

America/Maceio

America/Managua

America/Manaus

America/Marigot

America/Martinique

America/Matamoros

America/Mazatlan

America/Mendoza

America/Menominee

America/Merida

America/Metlakatla

America/Mexico_City

America/Miquelon

America/Moncton

America/Monterrey

America/Montevideo

America/Montreal

America/Montserrat

America/Nassau

America/New_York

America/Nipigon

America/Nome

America/Noronha

America/North_Dakota/Beulah

America/North_Dakota/Center

America/North_Dakota/New_Salem

America/Ojinaga

America/Panama

America/Pangnirtung

America/Paramaribo

America/Phoenix

America/Port-au-Prince

America/Port_of_Spain

America/Porto_Acre

America/Porto_Velho

America/Puerto_Rico

America/Rainy_River

America/Rankin_Inlet

America/Recife

America/Regina

America/Resolute

America/Rio_Branco

America/Rosario

America/Santa_Isabel

America/Santarem

America/Santiago

America/Santo_Domingo

America/Sao_Paulo

America/Scoresbysund

America/Shiprock

America/Sitka

America/St_Barthelemy

America/St_Johns

America/St_Kitts

America/St_Lucia

America/St_Thomas

America/St_Vincent

America/Swift_Current

America/Tegucigalpa

America/Thule

America/Thunder_Bay

America/Tijuana

America/Toronto

America/Tortola

America/Vancouver

America/Virgin

America/Whitehorse

America/Winnipeg

America/Yakutat

America/Yellowknife

Antarctica/Casey

Antarctica/Davis

Antarctica/DumontDUrville

Antarctica/Macquarie

Antarctica/Mawson

Antarctica/McMurdo

Antarctica/Palmer

Antarctica/Rothera

Antarctica/South_Pole

Antarctica/Syowa

Antarctica/Troll

Antarctica/Vostok

Arctic/Longyearbyen

Asia/Aden

Asia/Almaty

Asia/Amman

Asia/Anadyr

Asia/Aqtau

Asia/Aqtobe

Asia/Ashgabat

Asia/Ashkhabad

Asia/Atyrau

Asia/Baghdad

Asia/Bahrain

Asia/Baku

Asia/Bangkok

Asia/Barnaul

Asia/Beirut

Asia/Bishkek

Asia/Brunei

Asia/Calcutta

Asia/Chita

Asia/Choibalsan

Asia/Chongqing

Asia/Chungking

Asia/Colombo

Asia/Dacca

Asia/Damascus

Asia/Dhaka

Asia/Dili

Asia/Dubai

Asia/Dushanbe

Asia/Famagusta

Asia/Gaza

Asia/Harbin

Asia/Hebron

Asia/Ho_Chi_Minh

Asia/Hong_Kong

Asia/Hovd

Asia/Irkutsk

Asia/Istanbul

Asia/Jakarta

Asia/Jayapura

Asia/Jerusalem

Asia/Kabul

Asia/Kamchatka

Asia/Karachi

Asia/Kashgar

Asia/Kathmandu

Asia/Katmandu

Asia/Khandyga

Asia/Kolkata

Asia/Krasnoyarsk

Asia/Kuala_Lumpur

Asia/Kuching

Asia/Kuwait

Asia/Macao

Asia/Macau

Asia/Magadan

Asia/Makassar

Asia/Manila

Asia/Muscat

Asia/Nicosia

Asia/Novokuznetsk

Asia/Novosibirsk

Asia/Omsk

Asia/Oral

Asia/Phnom_Penh

Asia/Pontianak

Asia/Pyongyang

Asia/Qatar

Asia/Qyzylorda

Asia/Rangoon

Asia/Riyadh

Asia/Saigon

Asia/Sakhalin

Asia/Samarkand

Asia/Seoul

Asia/Shanghai

Asia/Singapore

Asia/Srednekolymsk

Asia/Taipei

Asia/Tashkent

Asia/Tbilisi

Asia/Tehran

Asia/Tel_Aviv

Asia/Thimbu

Asia/Thimphu

Asia/Tokyo

Asia/Tomsk

Asia/Ujung_Pandang

Asia/Ulaanbaatar

Asia/Ulan_Bator

Asia/Urumqi

Asia/Ust-Nera

Asia/Vientiane

Asia/Vladivostok

Asia/Yakutsk

Asia/Yangon

Asia/Yekaterinburg

Asia/Yerevan

Atlantic/Azores

Atlantic/Bermuda

Atlantic/Canary

Atlantic/Cape_Verde

Atlantic/Faeroe

Atlantic/Faroe

Atlantic/Jan_Mayen

Atlantic/Madeira

Atlantic/Reykjavik

Atlantic/South_Georgia

Atlantic/St_Helena

Atlantic/Stanley

Australia/ACT

Australia/Adelaide

Australia/Brisbane

Australia/Broken_Hill

Australia/Canberra

Australia/Currie

Australia/Darwin

Australia/Eucla

Australia/Hobart

Australia/LHI

Australia/Lindeman

Australia/Lord_Howe

Australia/Melbourne

Australia/North

Australia/NSW

Australia/Perth

Australia/Queensland

Australia/South

Australia/Sydney

Australia/Tasmania

Australia/Victoria

Australia/West

Australia/Yancowinna

Brazil/Acre

Brazil/DeNoronha

Brazil/East

Brazil/West

Canada/Atlantic

Canada/Central

Canada/Eastern

Canada/Mountain

Canada/Newfoundland

Canada/Pacific

Canada/Saskatchewan

Canada/Yukon

CET

Chile/Continental

Chile/EasterIsland

CST6CDT

Cuba

EET

Egypt

Eire

EST

EST5EDT

Etc/GMT

Etc/GMT-0

Etc/GMT-1

Etc/GMT-10

Etc/GMT-11

Etc/GMT-12

Etc/GMT-13

Etc/GMT-14

Etc/GMT-2

Etc/GMT-3

Etc/GMT-4

Etc/GMT-5

Etc/GMT-6

Etc/GMT-7

Etc/GMT-8

Etc/GMT-9

Etc/GMT+0

Etc/GMT+1

Etc/GMT+10

Etc/GMT+11

Etc/GMT+12

Etc/GMT+2

Etc/GMT+3

Etc/GMT+4

Etc/GMT+5

Etc/GMT+6

Etc/GMT+7

Etc/GMT+8

Etc/GMT+9

Etc/GMT0

Etc/Greenwich

Etc/UCT

Etc/Universal

Etc/UTC

Etc/Zulu

Europe/Amsterdam

Europe/Andorra

Europe/Astrakhan

Europe/Athens

Europe/Belfast

Europe/Belgrade

Europe/Berlin

Europe/Bratislava

Europe/Brussels

Europe/Bucharest

Europe/Budapest

Europe/Busingen

Europe/Chisinau

Europe/Copenhagen

Europe/Dublin

Europe/Gibraltar

Europe/Guernsey

Europe/Helsinki

Europe/Isle_of_Man

Europe/Istanbul

Europe/Jersey

Europe/Kaliningrad

Europe/Kiev

Europe/Kirov

Europe/Lisbon

Europe/Ljubljana

Europe/London

Europe/Luxembourg

Europe/Madrid

Europe/Malta

Europe/Mariehamn

Europe/Minsk

Europe/Monaco

Europe/Moscow

Europe/Nicosia

Europe/Oslo

Europe/Paris

Europe/Podgorica

Europe/Prague

Europe/Riga

Europe/Rome

Europe/Samara

Europe/San_Marino

Europe/Sarajevo

Europe/Saratov

Europe/Simferopol

Europe/Skopje

Europe/Sofia

Europe/Stockholm

Europe/Tallinn

Europe/Tirane

Europe/Tiraspol

Europe/Ulyanovsk

Europe/Uzhgorod

Europe/Vaduz

Europe/Vatican

Europe/Vienna

Europe/Vilnius

Europe/Volgograd

Europe/Warsaw

Europe/Zagreb

Europe/Zaporozhye

Europe/Zurich

Factory

GB

GB-Eire

GMT

GMT-0

GMT+0

GMT0

Greenwich

Hongkong

HST

Iceland

Indian/Antananarivo

Indian/Chagos

Indian/Christmas

Indian/Cocos

Indian/Comoro

Indian/Kerguelen

Indian/Mahe

Indian/Maldives

Indian/Mauritius

Indian/Mayotte

Indian/Reunion

Iran

Israel

Jamaica

Japan

Kwajalein

Libya

MET

Mexico/BajaNorte

Mexico/BajaSur

Mexico/General

MST

MST7MDT

Navajo

NZ

NZ-CHAT

Pacific/Apia

Pacific/Auckland

Pacific/Bougainville

Pacific/Chatham

Pacific/Chuuk

Pacific/Easter

Pacific/Efate

Pacific/Enderbury

Pacific/Fakaofo

Pacific/Fiji

Pacific/Funafuti

Pacific/Galapagos

Pacific/Gambier

Pacific/Guadalcanal

Pacific/Guam

Pacific/Honolulu

Pacific/Johnston

Pacific/Kiritimati

Pacific/Kosrae

Pacific/Kwajalein

Pacific/Majuro

Pacific/Marquesas

Pacific/Midway

Pacific/Nauru

Pacific/Niue

Pacific/Norfolk

Pacific/Noumea

Pacific/Pago_Pago

Pacific/Palau

Pacific/Pitcairn

Pacific/Pohnpei

Pacific/Ponape

Pacific/Port_Moresby

Pacific/Rarotonga

Pacific/Saipan

Pacific/Samoa

Pacific/Tahiti

Pacific/Tarawa

Pacific/Tongatapu

Pacific/Truk

Pacific/Wake

Pacific/Wallis

Pacific/Yap

Poland

Portugal

PRC

PST8PDT

ROC

ROK

Singapore

Turkey

UCT

Universal

US/Alaska

US/Aleutian

US/Arizona

US/Central

US/East-Indiana

US/Eastern

US/Hawaii

US/Indiana-Starke

US/Michigan

US/Mountain

US/Pacific

US/Samoa

UTC

W-SU

WET

Zulu