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

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

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