دليل تسوق Google AI

نظرة عامة

يتيح بروتوكول التجارة الموحد من Google (UCP) لمساعدي Google AI اكتشاف منتجاتك ومساعدة العملاء في العثور على ما يحتاجونه وتسهيل عمليات الشراء. يغطي هذا الدليل إعداد تكامل UCP مع ZaLink.

المتطلبات الأساسية

• حساب ZaLink مع اشتراك نشط (مستوى Connect أو Manage)
• متجرك مرتبط بـ ZaLink (زد، سلة، شوبيفاي، أو ووكومرس)
• المنتجات متزامنة مع كتالوج ZaLink
• حساب Google Cloud Platform (للميزات المتقدمة)

الميزات حسب المستوى

ميزات UCP المتاحة تعتمد على مستوى اشتراكك:

الخطوة 1: تفعيل اتصال Google AI

انتقل إلى لوحة التحكم > اتصالات الذكاء الاصطناعي > Google وقم بتفعيل "تمكين تسوق Google AI". هذا يفعّل نقاط نهاية UCP لمتجرك.

الخطوة 2: إعداد الاكتشاف

حدد كيف يكتشف Google متجرك ومنتجاتك:

• اكتشاف المتجر: تمكين إيجاد متجرك بواسطة وكلاء Google
• اكتشاف المنتجات: إعداد تغذية المنتجات
• ربط الفئات: ربط فئاتك بتصنيف Google

الخطوة 3: إدارة الوكلاء

تحكم في الوكلاء الذين يمكنهم الوصول لمتجرك:

• الوكلاء المعتمدون: إضافة وكلاء Google محددين للقائمة البيضاء
• مستويات الوصول: تعيين صلاحيات القراءة/الكتابة لكل وكيل
• حدود الطلبات: إعداد حدود الطلبات لكل وكيل

الخطوة 4: ربط الهوية

تمكين ربط هوية العملاء للتجارب المخصصة:

• ربط حساب Google: السماح للعملاء بربط حسابات Google
• سجل الطلبات: تمكين الوصول لسجل الطلبات لإعادة الطلب
• التفضيلات: مزامنة تفضيلات العملاء عبر المنصات

الخطوة 5: إعداد OAuth

إعداد OAuth 2.0 للمصادقة الآمنة للوكلاء:

• معرف العميل: معرف عميل OAuth لمتجرك
• سر العميل: سر المصادقة المخزن بأمان
• عناوين إعادة التوجيه: عناوين URL المعتمدة للاستدعاء
• النطاقات: تحديد نطاقات الصلاحيات للوكلاء

التحقق من توقيع الويب هوك

يستخدم UCP توقيع ES256 (ECDSA مع SHA-256) للتحقق من توقيع الويب هوك. إليك كيفية التحقق من التوقيعات:

// التحقق من توقيع ES256 للويب هوك (Node.js)
import crypto from 'crypto';

function verifyUCPWebhook(payload: string, signature: string, publicKeyJWK: object): boolean {
  // تحويل JWK إلى تنسيق PEM
  const publicKey = crypto.createPublicKey({ key: publicKeyJWK, format: 'jwk' });

  // فك تشفير التوقيع base64url
  const signatureBuffer = Buffer.from(signature.replace(/-/g, '+').replace(/_/g, '/'), 'base64');

  // التحقق باستخدام ES256 (SHA-256)
  const verify = crypto.createVerify('SHA256');
  verify.update(payload);
  verify.end();

  return verify.verify(publicKey, signatureBuffer);
}

اختبار التكامل

تحقق من عمل تكامل UCP:

1. استخدم أداة اختبار UCP من Google للتحقق من نقاط النهاية
2. اختبر اكتشاف المنتجات باستعلامات نموذجية
3. تحقق من مسار الدفع بطلبات اختبارية
4. تحقق من تسليم الويب هوك لأحداث الطلبات

مرجع API

للمطورين الذين يبنون تكاملات مخصصة، راجع توثيق UCP API لنقاط نهاية الاكتشاف وإعداد OAuth وويب هوكات الأحداث.

استكشاف الأخطاء

• فشل الاكتشاف: تحقق من إمكانية الوصول لملف UCP manifest لمتجرك
• أخطاء OAuth: تحقق من بيانات العميل وعناوين إعادة التوجيه
• منتجات مفقودة: تأكد من أن المنتجات تلبي متطلبات Google
• رفض وصول الوكيل: راجع إعدادات القائمة البيضاء للوكلاء