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

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

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