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

تسرّع ميزة الدفع عملية الشراء للعملاء المستعدّين للشراء من خلال السماح لهم بالانتقال مباشرةً من بيانات المنتجات على 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): لتحديد نموذج عنوان URL واحد، إما checkout_uri_template أو cart_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، وألّا يطلب من العميل تسجيل الدخول.
  • يجب أن يتطابق النطاق من نموذج الدفع المقدَّم مع نطاق المنتج.

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