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

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

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

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

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

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

لاستخدام مورد CheckoutSettings والطرق المرتبطة به، تأكَّد من تنفيذ ما يلي:

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

الطُرق

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

• checkoutSettings.create
• checkoutSettings.get
• checkoutSettings.update
• checkoutSettings.delete

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

لإنشاء إعدادات الدفع، استخدِم طريقة 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 للدفع لمنتجاتك بطريقتَين:

• على مستوى الحساب (sub-API أو Merchant Center): لتحديد نموذج عنوان URL واحد، إما checkout_uri_template أو cart_uri_template، يمكنك استخدام sub-API أو إعدادات 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، ولا تتطلّب من العميل تسجيل الدخول.
• يجب أن يتطابق النطاق من نموذج الدفع المقدَّم مع نطاق المنتج.

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

• إضافة رابط دفع لمنتجاتك
• نموذج رابط الدفع