مرجع العميل

يتضمّن com.google.android.gms.wallet documentation مستندات كاملة للمكتبة على مستوى إصدارات متعددة من Google Pay API. في ما يلي ملخّص للعناصر والطُرق الأكثر صلة بأحدث إصدار من Google Pay API: الإصدار 2.0

محفظة Google

إنشاء PaymentsClient لبيئة اختبار أو إنتاج

مثال

mPaymentsClient = Wallet.getPaymentsClient(
  this,
  new Wallet.WalletOptions.Builder()
      .setEnvironment(WalletConstants.ENVIRONMENT_TEST)
      .build()
);

PaymentsClient

عميل للتفاعل مع واجهات Google Pay API

isReadyToPay(IsReadyToPayRequest)

استخدِم طريقة isReadyToPay(IsReadyToPayRequest) لتحديد ما إذا كان بإمكان المستخدم إرجاع طريقة دفع من Google Pay API.

إذا كان الجهاز متوافقًا مع Google Pay، وكان المستخدم قد حفظ طريقة دفع أو يمكنه إضافة طريقة دفع، تعرض الدالة IsReadyToPay القيمة true. لتحديد ما إذا كان المستخدم قد حفظ طريقة دفع في Google Pay، اضبط قيمة IsReadyToPayRequest.existingPaymentMethodRequired على true.

loadPaymentData(PaymentDataRequest)

عرض ورقة دفع Google Pay التي تتيح اختيار طريقة دفع وإعداد المَعلمات بشكل اختياري

IsReadyToPayRequest

أنشئ عنصر IsReadyToPayRequest Java مناسبًا للاستخدام مع PaymentsClient.isReadyToPay().

fromJson(java.lang.String)

أنشئ عنصر IsReadyToPayRequest Java من سلسلة بتنسيق JSON. راجِع مرجع عنصر IsReadyToPayRequest لمعرفة البنية المتوقّعة للسلسلة المقدَّمة بتنسيق JSON.

PaymentDataRequest

أنشئ عنصر PaymentDataRequest Java مناسبًا للاستخدام مع PaymentsClient.loadPaymentData.

fromJson(java.lang.String)

أنشئ PaymentDataRequest عنصر Java من سلسلة بتنسيق JSON. راجِع مرجع العنصر PaymentDataRequest لمعرفة البنية المتوقّعة للسلسلة المقدَّمة بتنسيق JSON.

PaymentData

التعامل مع استجابة بتنسيق JSON من Google Pay API لاستخدامها في تطبيقك

toJson()

إخراج استجابة Google Pay API كسلسلة بتنسيق JSON راجِع مرجع عنصر PaymentData لمزيد من المعلومات حول بنية عنصر JSON.

PayButton

public void initialize(ButtonOption buttonOptions)

يتم استخدام طريقة الملائمة لتهيئة زر دفع Google Pay مصمّم باستخدام أحدث علامة تجارية لـ Google Pay.

الوسيطات

الاسم الوصف
buttonOptions عنصر يضبط إعدادات زر الدفع في Google Pay. اطّلِع على ButtonOptions لمعرفة الخصائص القابلة للضبط.

مثال: تهيئة زر الدفع باستخدام إعدادات مخصّصة:

PayButton googlePayPaymentButton = layoutBinding.googlePayPaymentButton;
JSONArray paymentMethods = new JSONArray().put(getBaseCardPaymentMethod());
googlePayPaymentButton.initialize(
       ButtonOptions.newBuilder()
               .setButtonTheme(ButtonConstants.ButtonTheme.DARK)
               .setButtonType(ButtonConstants.ButtonType.BUY)
               .setCornerRadius(100)
               .setAllowedPaymentMethods(paymentMethods.toString())
               .build()
);

public void setVisibility(View view)

تضبط طريقة الدفع السهلة إمكانية ظهور زر الدفع.

الوسيطات

الاسم الوصف
View

يضبط View.VISIBLE زر الدفع على مرئي (تلقائي).

يؤدي الرمز View.GONE إلى إخفاء الزر عن المستخدمين.

مثال:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

يتم استدعاء الطريقة عندما ينقر المستخدم على زر الدفع في Google Pay.

الوسيطات

الاسم الوصف
listener دالة ردّ الاتصال الخاصة بمتتبّع الأحداث التي سيتم استدعاؤها عند تسليم حدث نقرة إلى زر الدفع في Google Pay.