- المورد: Subscriptionشراء
- مقدمة حول السعر التمهيدي
- SubscriptionsCancelSurveyResult
- ChangePriceChange
- الطُرق
المورد: Subscriptionشراء
يشير مورد شراء الاشتراكات إلى حالة شراء اشتراك المستخدم.
تمثيل JSON |
---|
{ "kind": string, "startTimeMillis": string, "expiryTimeMillis": string, "autoResumeTimeMillis": string, "autoRenewing": boolean, "priceCurrencyCode": string, "priceAmountMicros": string, "introductoryPriceInfo": { object ( |
الحقول | |
---|---|
kind |
ويمثّل هذا النوع كائن purchasepurchase في خدمة androidpublisher. |
startTimeMillis |
الوقت الذي تم فيه منح الاشتراك، بالمللي ثانية منذ النهاية. |
expiryTimeMillis |
الوقت الذي ستنتهي فيه صلاحية الاشتراك بالمللي ثانية منذ البداية. |
autoResumeTimeMillis |
الوقت الذي سيتم فيه استئناف الاشتراك تلقائيًا بالمللي ثانية منذ البداية. ولا يتم عرضها إلا إذا طلب المستخدم إيقاف الاشتراك مؤقتًا. |
autoRenewing |
ما إذا كان سيتم تجديد الاشتراك تلقائيًا عند حلول وقت انتهاء الصلاحية الحالي. |
priceCurrencyCode |
رمز العملة ISO 4217 لسعر الاشتراك. على سبيل المثال، إذا تم تحديد السعر بالجنيه الإسترليني، إذا كان priceCurrencyCode هو &&;;GBP". |
priceAmountMicros |
سعر الاشتراك، بالنسبة إلى البلدان غير شاملة الضرائب، لا يشمل السعر الضريبة. بالنسبة إلى البلدان التي تشمل الضرائب، يشمل السعر الضريبة. يتم التعبير عن السعر بوحدات صغيرة تمثّل 1,000,000 وحدة مصغّرة وحدة واحدة من العملة. على سبيل المثال، إذا كان سعر الاشتراك هو 1.99 يورو، يكون priceAmountMicros هو 1990000. |
introductoryPriceInfo |
معلومات السعر التمهيدي للاشتراك. ولا يتوفّر ذلك إلا عند شراء الاشتراك بسعر تمهيدي. لا يشير هذا الحقل إلى أنّ الاشتراك حاليًا في فترة أسعار تمهيدية. |
countryCode |
رمز المنطقة/البلد للفوترة في ISO 3166-1 alpha-2 للمستخدم في وقت منح الاشتراك. |
developerPayload |
سلسلة يحددها مطوّر البرامج تحتوي على معلومات تكميلية حول طلب ما. |
paymentState |
حالة الدفع الخاصة بالاشتراك. القيم المحتمَلة هي: 0. الدفعة 1. تم استلام الدفعة 2. فترة تجريبية مجانية 3. في انتظار الترقية/الرجوع إلى إصدار سابق مؤجل غير متوفّر للاشتراكات المُلغاة والمنتهية الصلاحية. |
cancelReason |
سبب إلغاء الاشتراك أو عدم تجديده تلقائيًا. القيم المحتمَلة هي: 0. ألغى المستخدم الاشتراك 1. ألغى النظام الاشتراك، مثلاً بسبب مشكلة في الفوترة 2. تم استبدال الاشتراك باشتراك جديد 3. تم إلغاء الاشتراك بواسطة مطوّر البرامج |
userCancellationTimeMillis |
الوقت الذي تم فيه إلغاء الاشتراك من قِبل المستخدم، بالملي ثانية منذ هذه الفترة. ويتوفّر العرض فقط في حال كان سبب الإلغاء هو 0. |
cancelSurveyResult |
المعلومات التي يقدّمها المستخدم عند إكمال عملية إلغاء الاشتراك (استطلاع حول سبب الإلغاء). |
orderId |
مُعرّف الطلب لآخر طلب شراء متكرّر مرتبط بشراء الاشتراك. إذا تم إلغاء الاشتراك بسبب رفض الدفعة، سيكون هذا هو معرّف الطلب من الطلب الذي تم رفض الدفعة. |
linkedPurchaseToken |
الرمز المميز للشراء لعملية الشراء الأصلية إذا كان هذا الاشتراك هو أحد ما يلي: 0 إعادة تسجيل اشتراك مُلغى بدون أن تنتهي صلاحيته 1. الترقية/الرجوع إلى إصدار سابق من اشتراك سابق على سبيل المثال، لنفترض أن المستخدم اشترك في الأصل وحصلت على الرمز المميز للشراء X، ثم ألغى المستخدم عملية إعادة الاشتراك (قبل انتهاء صلاحية اشتراكه) وستتلقى رمز الشراء Y، وأخيرًا ترقية المستخدم لاشتراكه وتلقّي الرمز المميز للشراء Z. وإذا كنت توجّه واجهة برمجة التطبيقات هذه باستخدام الرمز المميز للشراء Z، سيتم ضبط هذا الحقل على Y. وإذا كنت تطلب واجهة برمجة التطبيقات هذه من خلال الرمز المميز للشراء Y، سيتم ضبط هذا الحقل على X. إذا كنت توجّه واجهة برمجة التطبيقات هذه باستخدام الرمز المميز للشراء X، لن يتم ضبط هذا الحقل. |
purchaseType |
نوع شراء الاشتراك. يتم ضبط هذا الحقل فقط إذا لم يتم إجراء عملية الشراء هذه باستخدام مسار الفوترة العادي داخل التطبيقات. القيم المحتمَلة هي: 0. اختبار (أي تم شراؤه من حساب اختبار ترخيص) 1. العرض الترويجي (أي الذي تم شراؤه باستخدام رمز ترويجي) |
priceChange |
تتوفّر أحدث معلومات تغيير السعر. لا تتوفر هذه الميزة إلا في حال حدوث تغيير في سعر الاشتراك بعد. بعد تجديد الاشتراك بالسعر الجديد أو إلغاء الاشتراك، لن يتم إرجاع أي معلومات عن تغيير السعر. |
profileName |
اسم الملف الشخصي للمستخدم عند شراء الاشتراك. متاح فقط لعمليات الشراء التي تم إجراؤها باستخدام '؛الاشتراك مع Google'؛ |
emailAddress |
عنوان البريد الإلكتروني للمستخدم عند شراء الاشتراك. متاح فقط لعمليات الشراء التي تم إجراؤها باستخدام '؛الاشتراك مع Google'؛ |
givenName |
الاسم المحدَّد للمستخدم عند شراء الاشتراك. متاح فقط لعمليات الشراء التي تم إجراؤها باستخدام '؛الاشتراك مع Google'؛ |
familyName |
اسم عائلة المستخدم عند شراء الاشتراك. متاح فقط لعمليات الشراء التي تم إجراؤها باستخدام '؛الاشتراك مع Google'؛ |
profileId |
رقم تعريف الملف الشخصي في Google للمستخدم عند شراء الاشتراك. متاح فقط لعمليات الشراء التي تم إجراؤها باستخدام '؛الاشتراك مع Google'؛ |
acknowledgementState |
حالة الإقرار لمنتج الاشتراك. القيم المحتمَلة هي: 0. ولم يتم استلامك بعد. تمت الموافقة |
externalAccountId |
معرّف حساب المستخدم في الخدمة التابعة لجهة خارجية. ويتوفّر ذلك فقط إذا تم ربط الحساب كجزء من عملية شراء الاشتراك. |
promotionType |
نوع العرض الترويجي الذي تم تطبيقه على عملية الشراء هذه. يتم ضبط هذا الحقل فقط في حال تطبيق عرض ترويجي عند شراء الاشتراك. القيم المحتمَلة هي: 0. رمز مرة واحدة 1. رمز مخصص |
promotionCode |
الرمز الترويجي الذي تم تطبيقه على عملية الشراء هذه لا يتم ضبط هذا الحقل إلا إذا تم تطبيق عرض ترويجي للرموز المميزة عند شراء الاشتراك. |
obfuscatedExternalAccountId |
هي إصدار يتضمن تشويشًا لرقم التعريف المرتبط بشكل فريد بحساب المستخدم في تطبيقك. ويُرجى مشاركة العرض مع عمليات الشراء التالية: * في حال ربط الحساب كجزء من عملية شراء الاشتراك. * تم تحديده باستخدام https://developer.android.com/reference/com/android/billingclient/api/billingFlowParams.Builder#setobfuscatedaccountid عند إجراء عملية الشراء. |
obfuscatedExternalProfileId |
هو إصدار يتضمن تشويشًا لرقم التعريف المرتبط بشكلٍ فريد بالملف الشخصي للمستخدم في تطبيقك. ولا يتم عرضه إلا في حال تحديده باستخدام https://developer.android.com/reference/com/android/billingclient/api/billingFlowParams.Builder#setobfuscatedprofileid. |
معلومات السعر التمهيدي
يتضمن معلومات السعر التمهيدي للاشتراك.
تمثيل JSON |
---|
{ "introductoryPriceCurrencyCode": string, "introductoryPriceAmountMicros": string, "introductoryPricePeriod": string, "introductoryPriceCycles": integer } |
الحقول | |
---|---|
introductoryPriceCurrencyCode |
رمز العملة ISO 4217 لسعر الاشتراك التمهيدي. على سبيل المثال، إذا تم تحديد السعر بالجنيه الإسترليني، إذا كان priceCurrencyCode هو &&;;GBP". |
introductoryPriceAmountMicros |
السعر التمهيدي من الاشتراك، بدون تضمين الضريبة. العملة هي نفسها السعر priceCurrencyCode. يتم التعبير عن السعر بوحدات صغيرة تمثّل 1,000,000 وحدة مصغّرة وحدة واحدة من العملة. على سبيل المثال، إذا كان سعر الاشتراك هو 1.99 يورو، يكون priceAmountMicros هو 1990000. |
introductoryPricePeriod |
تمثّل هذه السمة فترة السعر التمهيدي، المحددة بتنسيق ISO 8601. القيم الشائعة هي (على سبيل المثال لا الحصر) "P1W" (أسبوع واحد) و"P1M" (شهر واحد) &&;;P3M" (ثلاثة أشهر)" &";P6M" (ستة أشهر)" و"& P&Y": (عام واحد). |
introductoryPriceCycles |
عدد المدة الزمنية للفوترة لعرض أسعار تمهيدية. |
نتيجة إلغاء الاستطلاع
المعلومات التي يقدّمها المستخدم عند إكمال عملية إلغاء الاشتراك (استطلاع حول سبب الإلغاء).
تمثيل JSON |
---|
{ "cancelSurveyReason": integer, "userInputCancelReason": string } |
الحقول | |
---|---|
cancelSurveyReason |
سبب الإلغاء الذي اختاره المستخدم في الاستطلاع. القيم المحتمَلة هي: 0. غير ذلك 1. لا أستخدم هذه الخدمة بما يكفي. المشاكل الفنية 3- الأسباب ذات الصلة بالتكلفة 4. اكتشفت تطبيقًا أفضل. |
userInputCancelReason |
سبب إلغاء الإدخال المخصص من المستخدم. ويتوفّر فقط عندما يكون الإلغاء"> هو 0. |
تغيير سعر الاشتراك
تحتوي على معلومات تغيير السعر الخاصة باشتراك يمكن استخدامه للتحكم في رحلة المستخدم في ما يتعلق بتغيير السعر في التطبيق. ويمكن أن يكون ذلك في شكل طلب تأكيد من المستخدم أو تخصيص التجربة للحصول على إحالة ناجحة ناجحة.
تمثيل JSON |
---|
{
"newPrice": {
object ( |
الحقول | |
---|---|
newPrice |
السعر الجديد الذي سيتم تجديد الاشتراك باستخدامه إذا وافق المستخدم على تغيير السعر. |
state |
الحالة الراهنة للتغيير في السعر. القيم المحتمَلة هي: 0. مُعلَّق: حالة التغيير المعلَّق للسعر الذي في انتظار موافقة المستخدم. وفي هذه الحالة، يمكنك اختياريًا طلب التأكيد من المستخدم باستخدام واجهة برمجة التطبيقات داخل التطبيق. 1- مقبول: تحديد التغيير المقبول في السعر الذي سيتم تجديده للاشتراك ما لم يتم إلغاؤه. يسري التغيير على السعر في التاريخ المستقبلي الذي يتم فيه تجديد الاشتراك. يُرجى العلم أنّ هذا التغيير قد لا يحدث عند تجديد الاشتراك في المرة القادمة. |
الطُرق |
|
---|---|
|
الإقرار بعملية شراء اشتراك. |
|
إلغاء شراء اشتراك المستخدم. |
|
تأجيل شراء اشتراك المستخدم حتى وقت انتهاء الصلاحية المحدّد في المستقبل |
|
للتحقق مما إذا كان شراء اشتراك المستخدم صالحًا ويعرض وقت انتهاء الصلاحية. |
|
يتم ردّ الأموال المدفوعة في شراء اشتراك المستخدم، ولكن يظل الاشتراك ساريًا إلى أن تنتهي صلاحيته، وسيستمر تكراره. |
|
ردّ الأموال وإبطال شراء اشتراك المستخدم على الفور. |