إدارة علاقات الحسابات

يمكنك استخدام واجهة برمجة التطبيقات الخاصة بالحسابات لإدارة العلاقات بين حسابك على Merchant Center ومقدّمي الخدمات الآخرين. العلاقة هي ارتباط رسمي يتيح لمزوّد الخدمة تقديم خدمات محدّدة لنشاطك التجاري. تحدّد الخدمة الأذونات والإمكانات الممنوحة لمقدّم الخدمة، مثل إدارة المنتجات أو إدارة الحملات. على سبيل المثال، يتيح ربط حسابك على Merchant Center بحساب على "إعلانات Google" لحساب "إعلانات Google" استخدام بيانات منتجاتك لتشغيل الحملات الإعلانية.

تتألف العلاقة من السمات التالية:

• حساب Merchant Center الذي يتلقّى الخدمة
• مقدّم الخدمة
• الخدمة أو مجموعة الخدمات المقدَّمة إلى حساب Merchant Center

الاسم المستعار

يمكن لمقدّمي الخدمات ربط اسم مستعار بالحسابات التي يقدّمون خدماتهم لها (هذا الاسم هو المكافئ للحقل seller_id الذي كان متوفّرًا في المورد account في 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. يمكن أيضًا اقتراح هذه الخدمة لحساب حالي.

مصافحة

لإنشاء خدمة، يجب أن يمنح كل من الحساب الذي يقدّم الخدمة والحساب الذي يتلقّى الخدمة الإذن بالاتصال. تُعرف عملية التفويض هذه باسم المصافحة.

تتألف عملية المصافحة من خطوتَين:

1. يقترح أحد الطرفين ربط حساب الخدمة.
2. يوافق الطرف الآخر على الاقتراح أو يرفضه.

بعد قبول الاقتراح، تتم الموافقة على الخدمة ويتم اعتبارها منشأة بالكامل. يتم الآن منح أي حق وصول تم منحه لمقدّم الخدمة للمستخدمين المؤهّلين (راجِع حقوق الوصول أدناه).

يُرجى العِلم أنّ المستخدم الذي ينشئ اقتراحًا أو يرفضه أو يوافق عليه يجب أن تتوفّر لديه 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 كاملة. يُرجى العِلم أنّ هذا الإجراء سيقتصر في المستقبل على حقوق الوصول المرتبطة بالمنتجات فقط.

كيفية تطبيق العلاقات على المنصات التابعة لجهات خارجية

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

1. مقدّم الخدمة: حسابك المتقدّم
2. الحساب الذي يتلقّى الخدمة: هو حساب على Merchant Center يمثّل النشاط التجاري الذي تديره.
3. الخدمة:
   • ‫accountManagement: هذه هي الخدمة المقترَحة لمنصات التجارة الإلكترونية وشركاء القنوات الذين ينشئون حسابات جديدة نيابةً عن التجّار. ويتم إنشاء حساب يملكه التاجر ويكون مرتبطًا بك لأغراض الإدارة. يتوافق ذلك مع بنية Merchant Center المفضّلة لحالة الاستخدام هذه.
   • ‫accountAggregation: تربط هذه الخدمة حسابك بامتيازات متقدّمة بحساب آخر. مع أنّ هذه الميزة متاحة، لا ننصح بها لمنصات التجارة الإلكترونية وشركاء القنوات.

للحصول على تفاصيل حول كيفية إعداد حساب متقدّم والربط بحسابات Merchant Center جديدة، يُرجى الاطّلاع على إنشاء حسابات.