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

يمكنك استخدام Accounts API لإدارة العلاقات بين حسابك على 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". يمكن أيضًا اقتراح هذه الخدمة على حساب حالي.

• مقارنة الأسعار: يمثّل ذلك العلاقة مع خدمة مقارنة أسعار تدير حساب Merchant Center.

• إدارة بطاقات البيانات المحلية: يمثّل ذلك العلا101قة مع مدير متجر لإدارة المستودع المحلي وبطاقات البيانات باستخدام ملف تجاري على 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. مقدّم الخدم1}: حسابك المتقدّم account.
2. الحساب الذي يتلقّى الخدمة: حساب على Merchant Center يمثّل المؤسسة التي تديرها
3. الخدمة:
   • accountManagement: هذه هي الخدمة المقترَحة لمنصات التجارة الإلكترونية وشركاء القنوات الذين ينشئون حسابات جديدة نيابةً عن التجّار. تنشئ هذه الخدمة حسابًا يملكه التاجر، ويكون مرتبطًا بك لأغراض الإدارة. يتوافق ذلك مع بنية Merchant Center المفضّلة لحالة الاستخدام هذه.
   • accountAggregation: تربط هذه الخدمة حسابك بامتيازات متقدّمة بحساب آخر. على الرغم من أنّ هذه الخدمة متاحة، لا ننصح بها لمنصات التجارة الإلكترونية وشركاء القنوات.

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