يمكنك استخدام واجهة برمجة التطبيقات الخاصة بالحسابات لإدارة العلاقات بين حسابك على Merchant Center ومقدّمي الخدمات الآخرين. العلاقة هي ارتباط رسمي يتيح لمزوّد الخدمة تقديم خدمات محدّدة لنشاطك التجاري. تحدّد الخدمة الأذونات والإمكانات الممنوحة لمقدّم الخدمة، مثل إدارة المنتجات أو إدارة الحملات. على سبيل المثال، يتيح ربط حسابك على Merchant Center بحساب على "إعلانات Google" لحساب "إعلانات Google" استخدام بيانات منتجاتك لتشغيل الحملات الإعلانية.
تتألف العلاقة من السمات التالية:
- حساب Merchant Center الذي يتلقّى الخدمة
- مقدّم الخدمة
- الخدمة أو مجموعة الخدمات المقدَّمة إلى حساب Merchant Center
الاسم المستعار
يمكن لمقدّمي الخدمات ربط اسم مستعار بالحسابات التي يقدّمون خدماتهم لها (هذا الاسم هو المكافئ للحقل seller_id الذي كان متوفّرًا في مصدر الحساب في Content API for Shopping). يمكن تعيين الاسم المستعار باستخدام الحقل الاختياري account_id_alias ضمن المرجع AccountRelationship، ويُستخدَم كمعرّف مخصّص. يجب أن يتألف الاسم المستعار من حرف واحد إلى 50 حرفًا
يتم اختيارها من أحرف ASCII أو الأرقام العشرية أو الواصلات أو الشرطات السفلية أو النقاط أو
علامات التلدة ([A-Za-z0-9_~.-]{1,50}).
بنية عنوان URL للوصول إلى حساب باستخدام الاسم المستعار هي
GET /accounts/v1/accounts/{provider}~{account_id_alias}.
الخدمات
في Accounts API، يمكن أن تتلقّى الحسابات الخدمات التالية. يمكنك إضافة العديد من هذه الخدمات أثناء إنشاء الحساب.
تجميع الحسابات: تربط هذه الخدمة حسابًا بامتيازات متقدّمة بحساب آخر، ما يمنح الحساب بامتيازات متقدّمة إذن الوصول الكامل وغير المقيد. يُستخدم عادةً من قِبل الأسواق أو تجار التجزئة الذين يبيعون منتجات من علامات تجارية متعددة أو تجار التجزئة الدوليين الذين يحتاجون إلى تحكّم مركزي في الحسابات المتداخلة. إذا كنت شريكًا في منصة أو قناة للتجارة الإلكترونية، ننصحك باستخدام
accountManagementبدلاً من ذلك. عند إنشاء حساب باستخدام ميزة تجميع الحسابات، يجب حذفexternalAccountId.إدارة الحملات: تعمل هذه الخدمة على تصميم الرابط بين حساب على Merchant Center وحساب على "إعلانات Google"، ما يمنح حساب "إعلانات Google" إمكانية الوصول إلى بيانات المنتجات والحساب اللازمة لتنفيذ الحملات الإعلانية. مقدّم الخدمة في هذه الحالة هو
GOOGLE_ADS، وexternalAccountIdهو معرّف حساب "إعلانات Google". يمكن أيضًا اقتراح هذه الخدمة لحساب حالي.مقارنة الأسعار: يمثّل هذا الحقل العلاقة مع خدمة مقارنة أسعار (CSS) تدير حساب Merchant Center.
إدارة بيانات النشاط التجاري المحلية: تمثّل هذه السمة العلاقة مع مدير متجر لإدارة المخزون المحلي وبيانات النشاط التجاري باستخدام ملف تجاري على Google.
إدارة الحساب: تتيح هذه الخدمة لمقدّم الخدمة تنفيذ إجراءات إدارية على حساب Merchant Center، مثل ضبط إعدادات الحساب أو إدارة المستخدمين أو تعديل معلومات النشاط التجاري. يمكن للمؤسسة أيضًا تقييد إذن الوصول الممنوح. عند استخدام هذه الخدمة أثناء إنشاء الحساب، يتم إنشاء حساب مرتبط بمقدّم الخدمة، وهو الأسلوب الذي ننصح به لمنصات التجارة الإلكترونية وشركاء القنوات. يمكن أيضًا اقتراحها لحساب حالي.
إدارة المنتجات: تتيح هذه الخدمة للموفّرين إدارة المنتجات والميزات ذات الصلة، مثل مصادر البيانات والقواعد. عند إضافته أثناء إنشاء الحساب، يكون عادةً مصحوبًا بالرمز
accountManagementأوaccountAggregation. يمكن أيضًا اقتراح هذه الخدمة لحساب حالي.
مصافحة
لإنشاء خدمة، يجب أن يمنح كل من الحساب الذي يقدّم الخدمة والحساب الذي يتلقّى الخدمة الإذن بالاتصال. وتُعرف عملية التفويض هذه باسم المصافحة.
المصافحة هي عملية تتضمّن خطوتَين:
- يقترح أحد الطرفين ربط الخدمة.
- يوافق الطرف الآخر على الاقتراح أو يرفضه.
بعد قبول الاقتراح، تتم الموافقة على الخدمة ويتم اعتبارها منشأة بالكامل. يتم الآن منح أي حق وصول تم منحه لمقدّم الخدمة للمستخدمين المؤهّلين (راجِع حقوق الوصول أدناه).
يُرجى العِلم أنّ المستخدم الذي ينشئ عرضًا أو يرفضه أو يوافق عليه يجب أن تتوفّر لديه ADMIN أذونات الوصول إلى الحساب الذي يبدأ العملية. لذلك، إذا كان مقدّم الخدمة يقترح خدمة، يجب أن يكون المستخدم الذي يقدّم الاقتراح ADMIN في حساب مقدّم الخدمة، ويجب أن يكون المستخدم الذي يقبل الاقتراح أو يرفضه ADMIN في الحساب المستلِم.
سلوك المصافحة الخاص بالخدمة
في ما يلي وصف لمتطلبات المصافحة المحدّدة لكل خدمة على حدة:
تجميع الحسابات: لا يمكن إعداد هذه الخدمة إلا كجزء من عملية إنشاء الحساب. من المتوقّع أن يكون مقدّم الخدمة حسابًا متقدّمًا، ويتم تلقائيًا الموافقة على الخدمة لأنّ مستخدمي الحساب المتقدّم لديهم إذن وصول كامل
ADMINإلى الحساب الذي يتم إنشاؤه.مقارنة الأسعار: تتم الموافقة على هذه الخدمة تلقائيًا عند إضافتها أثناء إنشاء الحساب باستخدام
createAndConfigure.إدارة الحملات: على الرغم من أنّ هذه العملية تتّبع عملية المصافحة العادية، يتم تقديم الاقتراحات في نظام واحد (مثل "إعلانات Google") ويتم الحصول على الموافقات في النظام الآخر (مثل Merchant Center أو من خلال Merchant API).
إدارة البطاقات المحلية: بالنسبة إلى هذه الخدمة، يتم اقتراح المصافحة في طريقة مخصّصة، ويتم الحصول على الموافقات في النظام الآخر (مثل "الملف التجاري على Google"). يمكنك الاطّلاع على الخطوات التفصيلية في دليل ربط ملف تجاري على Google.
إدارة الحساب: بالنسبة إلى هذه الخدمة، تنطبق عملية المصافحة العادية عند استخدام
propose. إذا تمت إضافة الخدمة أثناء إنشاء الحساب باستخدامcreateAndConfigure، ستتم الموافقة عليها تلقائيًا.إدارة المنتجات: تنطبق على هذه الخدمة عملية المصافحة العادية (يقترح أحد الطرفين، ثم يقبل الطرف الآخر).
أذونات الوصول
يوفّر كل نوع خدمة مستوى معيّنًا من إذن الوصول لمستخدمي مقدّم الخدمة إلى الحساب الذي تتم خدمته:
تجميع الحسابات: تمنح هذه الخدمة حقوق
ADMINكاملة.إدارة الحملات: توفّر هذه الخدمة حق وصول محدودًا، ما يتيح لحساب "إعلانات Google" المرتبط الوصول إلى المنتجات ومعلومات الحساب الأساسية.
مقارنة الأسعار: توفّر هذه الخدمة تلقائيًا حقوق
ADMINالكاملة. ومع ذلك، يمكن للمؤسسة حظر الوصول الممنوح في Merchant Center.إدارة البطاقات المحلية: لا توفّر هذه الخدمة أي حق وصول مباشر. بدلاً من ذلك، يتيح هذا الخيار للمنتج المدرَج مزامنة منتجاته مع حساب Merchant Center.
ملاحظة مهمة: تنطبق حقوق الوصول الموضّحة لأنواع الخدمات التالية على مقدّمي الخدمات المعتمَدين فقط. يُرجى التواصل مع فريق الدعم إذا كنت مقدّم خدمة وتريد الاستفادة من هذه الإمكانية. إذا تمت الموافقة على استخدامك accounts.link سابقًا لإدارة المنتجات في Content API for Shopping، يمكنك استخدام هذه الخدمة في Merchant API بدون الحاجة إلى موافقات إضافية.
إدارة الحساب: توفّر هذه الخدمة تلقائيًا حقوق
ADMINكاملة.إدارة المنتجات: تمنح هذه الخدمة حقوق
ADMINكاملة. يُرجى العِلم أنّه سيتم في المستقبل حصر هذه الحقوق بحقوق الوصول المرتبطة بالمنتجات فقط.
كيفية تطبيق العلاقات على المنصات التابعة لجهات خارجية
إذا كنت منصة تابعة لجهة خارجية تدير حسابات نيابةً عن مؤسسات أخرى، يوضّح ما يلي كيفية ربط المفاهيم المختلفة ببنية حسابك:
- مقدّم الخدمة: حسابك المتقدّم
- الحساب الذي يتلقّى الخدمة: هو حساب على Merchant Center يمثّل النشاط التجاري الذي تديره.
- الخدمة:
accountManagement: هذه هي الخدمة المقترَحة لمنصات التجارة الإلكترونية وشركاء القنوات الذين ينشئون حسابات جديدة نيابةً عن التجّار. ويتم إنشاء حساب يملكه التاجر ويكون مرتبطًا بك لأغراض الإدارة. يتوافق ذلك مع بنية Merchant Center المفضّلة لحالة الاستخدام هذه.-
accountAggregation: تربط هذه الخدمة حسابك المتقدّم بحساب آخر. مع أنّ هذه الميزة متاحة، لا ننصح بها لمنصات التجارة الإلكترونية وشركاء القنوات.
للحصول على تفاصيل حول كيفية إعداد حساب بامتيازات متقدّمة والربط بحسابات جديدة على Merchant Center، يُرجى الاطّلاع على إنشاء حسابات.