تتيح لك واجهة برمجة التطبيقات الفرعية Accounts ضمن Merchant API إنشاء حساباتك على Google Merchant Center وضبطها وإدارتها آليًا. وتوفّر مجموعة شاملة من الأدوات لإدارة مراحل النشاط الكاملة والإعدادات الأساسية لحساباتك على Merchant Center. تُعدّ واجهة برمجة التطبيقات هذه ضرورية للأنشطة التجارية ومقدّمي الخدمات الخارجيين الذين يتطلّعون إلى برمجة عملية إعداد الحسابات والصيانة المستمرة.
باستخدام واجهة برمجة التطبيقات الفرعية Accounts، يمكنك إجراء ما يلي:
- تنفيذ العمليات الأساسية لحساب Merchant Center: إنشاء حسابات جديدة على Merchant Center، واسترداد تفاصيلها، وتعديل الإعدادات الأساسية، ومراقبة المشاكل على مستوى الحساب، وإدراج الحسابات التي يمكنك الوصول إليها، وحذف الحسابات عند الضرورة.
- تحديد معلومات مؤسستك وحضور متجرك على الإنترنت: يمكنك ضبط تفاصيل مؤسستك الأساسية (مثل العنوان ومعلومات الاتصال) وسمات الهوية المعلَنة ذاتيًا، وإعداد الموقع الإلكتروني لمتجرك على الإنترنت من خلال تحديد عنوان URL لصفحتك الرئيسية وإثبات ملكيته والمطالبة به. هذا هو المفتاح لكيفية تمثيل عملك.
- إدارة أذونات وصول المستخدمين وإعدادات التواصل المفضّلة: تعرَّف على كيفية تحديد المستخدمين الذين يمكنهم الوصول إلى حسابك على Merchant Center، وتحديد أذوناتهم، وضبط إعداداتهم المفضّلة لتلقّي الإشعارات عبر البريد الإلكتروني بشأن الأخبار والتعديلات المهمة في الحساب.
- إدارة التسجيل والمشاركة في البرامج: يمكنك إدارة تسجيلك في برامج Merchant Center المختلفة (مثل البيانات المجانية أو إعلانات Shopping)، وإدارة حالة مشاركتك، وفهم المتطلبات الخاصة بالبرنامج لتوسيع نطاق وصول منتجك إلى العملاء.
- ضبط الخدمات اللوجستية: الشحن والإرجاع والمناطق: اضبط إعدادات الشحن على مستوى الحساب، وحدِّد سياسات الإرجاع على الإنترنت للعملاء، وأنشئ مناطق جغرافية لاستهداف دقيق وتقديم الخدمات.
- الاستفادة من عمليات الدمج المتقدّمة وربط الحسابات: تعرَّف على كيفية إدارة إعدادات التجارب الشاملة، والربط بحسابات "الملف التجاري على Google" ومقدّمي خدمات "شراكة الخلاصات المحلية"، وإنشاء وإدارة علاقات الخدمة مع حسابات أخرى، مثل مقدّمي الخدمات أو الوكالات الخارجية.
تقدّم هذه المجموعة من الأدلة تعليمات وأمثلة مفصّلة لحالات الاستخدام الشائعة:
- إنشاء حساب: تعرَّف على خطوات إنشاء حساب جديد على Merchant Center وإدارة علاقاته مع حساب بامتيازات متقدّمة، وهو أمر ضروري لإدارة بائعين أو علامات تجارية متعددة.
- العلاقات: يمكنك فهم كيفية تنظيم وإدارة علاقات الخدمة بين حسابات Merchant Center المختلفة (مثل الحسابات بامتيازات متقدّمة أو مقدّمي الخدمات الخارجيين).
- ربط ملف تجاري على Google: يمكنك ربط حسابك على Merchant Center بملفك التجاري على Google لتعزيز حضور نشاطك التجاري المحلي.
- التحكّم في الوصول إلى حسابك: يمكنك إدارة أذونات المستخدمين وأدوارهم ضمن حسابك على Merchant Center للتحكّم في المستخدمين الذين يمكنهم تنفيذ إجراءات معيّنة.
- إدارة الإشعارات عبر البريد الإلكتروني في Merchant Center: يمكنك تخصيص الإشعارات عبر البريد الإلكتروني التي تتلقّاها أنت والمستخدمون الآخرون بشأن تنبيهات الحساب والأخبار والنصائح.
- إدارة إعدادات الصفحة الرئيسية: يمكنك ضبط عنوان URL للموقع الإلكتروني الخاص بمتجرك على الإنترنت وتأكيده والمطالبة به، وهي خطوة مهمة لتأكيد الحساب والمشاركة في البرنامج.
- نقل بيانات Content API: للتعرّف على كيفية نقل البيانات من Content API for Shopping، يُرجى الاطّلاع على مقالة نقل إدارة الحساب.
بنية حساب Merchant Center والعلاقات
تتيح منظومة Merchant Center المتكاملة استخدام بنى حسابات مختلفة لتلبية احتياجات الأنشطة التجارية المتنوعة. يمكن لهذه الحسابات أيضًا تكوين علاقات مع بعضها البعض، حيث يقدم حساب واحد (مقدم الخدمة) خدمات محددة لآخر. تتيح لك واجهة برمجة التطبيقات الفرعية Accounts sub-API التفاعل مع هذه الأنواع وعلاقاتها وإدارتها.
حسابات التجار
هذا حساب على Merchant Center، تستخدمه عادةً مؤسسة فردية لإدارة بيانات منتجاتها وبرامجها مباشرةً.
حالات الاستخدام الشائعة:
- الأنشطة التجارية الصغيرة والمتوسطة التي تدير حضورها في مجال التجارة الإلكترونية
- التجّار الذين يريدون التحكّم مباشرةً في إعداداتهم على Google Merchant Center
- التجّار الذين يستخدمون أدوات إنشاء المتاجر أو غيرها من مقدّمي الخدمات الخارجيين الذين يساعدون في إنشاء حساباتهم وإدارتها
العلاقات والخدمات:
يمكن ربط حسابات التجّار بمقدّمي الخدمات للحصول على المساعدة في مهام مثل إدارة بيانات المنتجات أو إدارة الحسابات والحملات.
الحسابات بامتيازات متقدّمة
الحساب بامتيازات متقدّمة هو حساب متخصّص ضمن Google Merchant Center. وهو مصمّم للمؤسسات ومقدّمي الخدمات الخارجيين (مثل منصات إنشاء المتاجر وشركاء القنوات والوكالات والأسواق) الذين يحتاجون إلى إدارة حسابات متعدّدة على Merchant Center على نطاق واسع.
حالات الاستخدام الشائعة:
- منصات إنشاء المتاجر: هي مقدّمو خدمات خارجيون يتيحون للتجّار إنشاء متاجرهم على الإنترنت وإدارتها.
- الأسواق: هي وجهات تسوّق على الإنترنت تستضيف عدة تجّار فرديين يبيعون منتجاتهم.
- التجّار الذين لديهم عدّة علامات تجارية: يملك هؤلاء التجار عدّة علامات تجارية ويبيعون المنتجات في المتاجر أو على الإنترنت من خلال نطاقات متعدّدة.
- بائعو التجزئة العالميون: هم بائعو التجزئة الذين يبيعون المنتجات في بلدان ونطاقات متعدّدة.
- شركاء القنوات: هم جهات تساعد التجّار في إدراج منتجاتهم على قنوات تسويقية مختلفة، وغالبًا ما يقدّمون خدمات ذات صلة.
- الوكالات: وكالات التسويق والإعلانات التي تدير حسابات Merchant Center وخلاصات المنتجات والحملات نيابةً عن عملائها
العلاقات والخدمات:
على الرغم من أنّ جميع الحسابات بامتيازات متقدّمة تدير حسابات متعددة للتجّار، غالبًا ما تختلف الإعدادات المثلى واستخدام العلاقات والخدمات استنادًا إلى نموذج الأعمال المحدّد. إنّ فهم هذه الاختلافات هو المفتاح للاستفادة من واجهة برمجة التطبيقات بفعالية. في ما يلي أفضل الممارسات المقترَحة لحالات الاستخدام الشائعة:
أدوات إنشاء المتاجر وشركاء القنوات
على هؤلاء الشركاء إنشاء حساب بامتيازات متقدّمة وإقامة علاقات مع التجّار الذين يعملون معهم:
- بالنسبة إلى التجّار الجدد الذين ليس لديهم حساب: عند تحويل حساب إلى حساب بامتيازات متقدّمة في واجهة مستخدم Merchant Center، تضبط Google تلقائيًا أدوات إنشاء المتاجر وشركاء القنوات كحسابات متعدّدة العملاء بامتيازات متقدّمة باستخدام خدمة
Account Aggregation(accountAggregation). يمكن لأداة إنشاء المتاجر أو الشريك في القناة استخدامaccounts.createAndConfigureمعaccountAggregationلإنشاء حسابات فرعية جديدة للتجّار، والتي تظهر في Merchant Center ويمكن إدارتها من خلاله. - بالنسبة إلى حسابات Merchant Center الحالية: لا يمكن نقل الحسابات المستقلة الحالية إلى حساب بامتيازات متقدّمة باستخدام
accountAggregation. بدلاً من ذلك، على منشئ المتجر أو شريك القناة إنشاء رابط خدمةAccount Management(accountManagement) مع حساب التاجر الفردي الحالي. يتيح ذلك لأداة إنشاء المتاجر أو الشريك في القناة إدارة جوانب من الحساب بموافقة التاجر.
سحب المعلومات للحسابات المُدارة: لاسترداد معلومات عن
حسابات التجّار التي تديرها من خلال accountManagement، يمكنك طلب
accounts.list باستخدام
فلتر relationship، على سبيل المثال،
filter=relationship(providerId={PROVIDER_ID} AND service(type="ACCOUNT_MANAGEMENT"))،
ثم طلب accounts.get
أو accountServices.list
لفحص تفاصيل حساب وخدمة معيّنة.
الوكالات
تدير الوكالات عادةً حسابات مستقلة على Merchant Center يملكها عملاؤها بدلاً من تجميع الحسابات الفرعية ضمن حساب واحد بامتيازات متقدّمة:
- بالنسبة إلى حسابات Merchant Center الحالية: تقترح الوكالة رابط خدمة
Account Management(accountManagement) (غالبًا ما يكون مدمجًا معProducts Management(productsManagement) أوCampaign Management(campaignsManagement))، ويوافق عليه التاجر. - بالنسبة إلى التجّار الجدد الذين ليس لديهم حساب: يمكن للوكالة الاتصال بـ
accounts.createAndConfigureباستخدام خدمةAccount Management(accountManagement) وإضافة التاجر كمستخدمADMINلكي يحتفظ التاجر بملكية الحساب المستقل.
الأسواق
تدير الأسواق حسابًا واحدًا بامتيازات متقدّمة لكل نطاق وتنشئ حسابات بائعين باستخدام خدمة Account Aggregation. من الشائع أن تستخدم الأسواق أنواعًا متعددة من البائعين، ويتطلّب بعضها إعدادات إضافية من فريق الدعم في Google. تتم المطالبة بالنطاق وإدارة البرنامج على مستوى الحساب بامتيازات متقدّمة، ويتم توريثهما إلى حسابات البائعين. لمزيد من التفاصيل، يُرجى الرجوع إلى مقالة مركز المساعدة حول بنية حساب السوق الصالحة.
- حساب البائع التابع للسوق: هو حساب مخصّص للمنتجات الخاصة بالسوق. يتيح ذلك للسوق استخدام تمييز العلامة التجارية وتقييمات البائعين واستراتيجيات حملات الطرف الأول المحدّدة.
- حسابات البائع الفردي: يحتوي كل حساب على منتجات لبائع خارجي واحد. هذه البنية مثالية للبائعين الكبار الذين يحتاجون إلى سمات مميّزة خاصة بهم أو الذين يطلقون حملات إعلانية خاصة بهم.
- الحسابات المتعدّدة البائعين: يحتوي حساب واحد على منتجات من بائعين خارجيين متعدّدين، ما يسهّل إدارة الحسابات والمنتجات. لمزيد من التفاصيل، يُرجى الرجوع إلى مقالة مركز المساعدة حول الحسابات المتعدّدة البائعين.
التجّار الذين لديهم عدّة علامات تجارية
تستخدم الأنشطة التجارية التي تضم علامات تجارية متعددة عادةً حسابًا بامتيازات متقدّمة لإدارة الحسابات الفردية لكل علامة تجارية، ويتم ربطها باستخدام خدمة Account Aggregation. يتيح ذلك للعلامات التجارية العمل بشكل مستقل (مثل المطالبات المتعلقة بالموقع الإلكتروني وبيانات المنتجات)، بينما يسهّل الحساب بامتيازات متقدّمة الوظائف المركزية، مثل وصول المستخدمين وإعداد التقارير والإشراف على الحملات في بعض الأحيان.
بائعو التجزئة الدوليون
يدير بائعو التجزئة الدوليون حضورهم العالمي باستخدام حساب بامتيازات متقدّمة،
مع حسابات فردية لكل بلد أو منطقة مرتبطة باستخدام خدمة Account
Aggregation. غالبًا ما يختلف إعدادها بناءً على بنية النطاق:
- نطاق واحد (مع نطاقات فرعية/مسارات خاصة بالبلد): تتم المطالبة بالنطاق الرئيسي عادةً على مستوى حساب بامتيازات متقدّمة، وتكتسبه الحسابات الإقليمية. بعد ذلك، تركّز هذه الحسابات الإقليمية على إدارة بيانات المنتجات المحلية وأسعارها ومدى توفّرها.
- نطاقات متعددة خاصة ببلدان معيّنة: يطالب كل حساب إقليمي بنطاقه الخاص. في هذا النموذج، تتولّى الحسابات الفردية العمليات المحلية، بينما يُستخدَم الحساب بامتيازات متقدّمة بشكل أساسي للوظائف المركزية، مثل وصول المستخدمين وإعداد التقارير العامة وإدارة الحملات الشاملة.