إدارة إعدادات الدفع

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

باستخدام Merchant API، يمكنك إدارة إعدادات هذه الميزة باستخدام مورد CheckoutSettings.

يشرح هذا الدليل كيفية استخدام Merchant API لإنشاء تسجيلك في ميزة الدفع وإدارته آليًا.

لمزيد من المعلومات، اطّلِع على مقالة إضافة رابط دفع لمنتجاتك.

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

لاستخدام مرجع CheckoutSettings والأساليب المرتبطة به، احرص على تنفيذ ما يلي:

  • يجب أن تكون قد حصلت على موافقة للمشاركة في "إعلانات Shopping" أو البيانات المجانية أو كليهما.
  • يجب أن يكون بلد البيع هو الولايات المتحدة.

الطُرق

لإنشاء إعدادات الدفع واستردادها وتعديلها وحذفها، يمكنك استخدام الخطوات التالية:

إنشاء إعدادات الدفع

لإنشاء إعداد دفع، استخدِم الطريقة checkoutSettings.create. أدرِج uri_settings مع checkout_uri_template أو cart_uri_template وeligible_destinations المحدّد في جسد الطلب.

في ما يلي مثال على طلب:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

استبدِل {ACCOUNT_ID} بالمعرّف الفريد لحسابك على Merchant Center.

في ما يلي مثال على ردّ من مكالمة ناجحة:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

استرداد إعدادات الدفع

لاسترداد إعدادات الدفع، بما في ذلك نموذج عنوان URL والوجهات التي تم اختيارها وحالة التسجيل وحالة مراجعة عنوان URL، استخدِم الطريقة checkoutSettings.get.

في ما يلي مثال على طلب:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

في ما يلي مثال على ردّ من مكالمة ناجحة:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

تعديل إعدادات الدفع

لتعديل إعدادات الدفع، استخدِم checkoutSettings.update الطريقة. أدرِج الحقول التي تريد تغييرها في محتوى الطلب وحدِّد هذه الحقول في مَعلمة طلب البحث update_mask.

تتيح update_mask الحقول التالية:

  • eligible_destinations
  • uri_settings

في ما يلي نموذج طلب لتعديل عنوان URL وإزالة وجهة الإعلانات:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

في ما يلي مثال على ردّ من مكالمة ناجحة:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

حذف

لحذف إعدادات الدفع، استخدِم الطريقة checkoutSettings.delete.

يؤدي هذا الإجراء إلى إزالة الإعدادات على مستوى الحساب وإلغاء تسجيلك في برنامج الدفع وإيقاف ظهور روابط الدفع على منتجاتك في البيانات المجانية وإعلانات Shopping.

في ما يلي مثال على طلب:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

يعرض الطلب الناجح نص استجابة فارغًا.

تتوفّر لك طريقتان لتقديم عناوين URL للدفع لمنتجاتك:

  • على مستوى الحساب (واجهة برمجة التطبيقات الفرعية أو Merchant Center): لتحديد checkout_uri_template أو cart_uri_template، وهو checkout_uri_template أو cart_uri_template، يمكنك استخدام checkout_uri_template أو إعدادات Merchant Center. يتم تطبيق هذا النموذج على جميع منتجاتك المؤهّلة. ننصحك باستخدام عنوان URL متسق في جميع منتجاتك. على سبيل المثال: yourstore.com/checkout?id={id}.

  • على مستوى المنتج (الخلاصة): لتقديم عنوان URL محدّد لصفحة الدفع لمنتجات فردية، استخدِم سمة checkout_link_template في خلاصة المنتجات. يتيح ذلك استخدام عناوين URL مخصّصة لكل منتج أو يتيح لك توفير ميزة الدفع لمجموعة فرعية فقط من مستودعك.

  • في حال ضبط نموذج عنوان URL على مستوى الحساب باستخدام واجهة برمجة التطبيقات الفرعية هذه، تأكَّد من عدم إرسال قيم لسمة checkout_link_template في خلاصتك لهذه المنتجات.

  • في حال استخدام سمة خلاصة checkout_link_template، تأكَّد من عدم ضبط نموذج عنوان URL على مستوى الحساب باستخدام واجهة برمجة التطبيقات الفرعية أو إعدادات Merchant Center. سيظل بإمكانك استخدام واجهة برمجة التطبيقات الفرعية لاختيار eligible_destinations بدون تقديم uri_settings إذا كنت تدير عناوين URL من خلال الخلاصة فقط.

نموذج عنوان URL للدفع

يتيح لك نموذج عنوان URL الخاص بالدفع تضمين عنوان URL للدفع في بيانات منتجاتك، ما يتيح للمتسوّقين على الإنترنت الانتقال مباشرةً إلى صفحة الدفع من بيانات منتجاتك. يجب أن يحتوي على العنصر النائب للمَعلمة {ID} وأن يكون لديه نطاق مطابق.

عند إعداد روابط الدفع باستخدام واجهة برمجة التطبيقات الفرعية، استخدِم الحقل uri_settings. يقبل هذا الحقل أحد النموذجَين التاليَين:

  • checkout_uri_template: نموذج عنوان URL يوجّه المستخدِم إلى صفحة الدفع عند ملء العنصر النائب، مع تضمين السلعة المحدّدة التي يمكن شراؤها.
  • ‫cart_uri_template: نموذج عنوان URL يوجّه المستخدِم إلى صفحة سلة التسوّق التي تحتوي على السلعة المحدّدة التي تمت إضافتها إلى سلة التسوّق

أمثلة على النماذج

  • الدفع: https://www.your-store.com/checkout?item_id={id}
  • سلة التسوّق: https://shop.your-store.com/add_to_cart?product_sku={id}

يجب استيفاء المتطلبات التالية:

  • يجب أن يشير نموذج عنوان URL إلى صفحة صالحة على موقعك الإلكتروني تتطابق مع نطاقك المسجَّل، وأن يعمل باستخدام HTTP GET، وألّا يتطلّب من العميل تسجيل الدخول.
  • يجب أن يتطابق النطاق الوارد في نموذج الدفع المقدَّم مع نطاق المنتج.

مزيد من المعلومات