REST Resource: purchases.subscriptionsv2

{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}

string

يمثِّل هذا النوع عنصر SubscriptionPurchaseV2 في خدمة androidpublisher.

string

رمز بلد/منطقة الفوترة للمستخدم في وقت منح الاشتراك وفقًا لمعيار ISO 3166-1 alpha-2

object (SubscriptionPurchaseLineItem)

معلومات على مستوى المنتج أو الخدمة عن شراء اشتراك يجب أن تكون جميع العناصر ضمن عملية الشراء نفسها إما مع AutoRenewingPlan أو جميعها خطة مسبقة الدفع.

string (Timestamp format)

وقت منح الاشتراك لم يتم ضبطه للاشتراكات المعلّقة (تم إنشاء الاشتراك ولكنه في انتظار الدفع أثناء الاشتراك).

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

enum (SubscriptionState)

الحالة الحالية للاشتراك.

string

مُعرّف الطلب لأحدث طلب مرتبط بشراء الاشتراك. بالنسبة إلى التجديد التلقائي للاشتراك، هذا هو مُعرّف الطلب لطلب الاشتراك إذا لم يتم تجديده بعد، أو معرّف آخر طلب متكرر (طلب ناجح أو في انتظار المراجعة أو مرفوض). بالنسبة إلى الاشتراك المدفوع مسبقًا، هذا هو مُعرّف الطلب المرتبط بالرمز المميز للشراء الذي تم طلبه.

string

رمز الشراء المميّز للاشتراك القديم إذا كان هذا الاشتراك أيًا مما يلي: * إعادة الاشتراك في اشتراك مُلغى ولكنه لم يتم انتهاء صلاحيته * ترقية الاشتراك أو الرجوع إلى إصدار سابق من اشتراك سابق * يمكنك التحويل من اشتراك مدفوع مسبقًا إلى اشتراك يتم تجديده تلقائيًا. * يمكنك التحويل من اشتراك يتم تجديده تلقائيًا إلى اشتراك مدفوع مسبقًا. * إضافة رصيد إلى اشتراك مسبق الدفع

object (PausedStateContext)

سياق إضافي حول الاشتراكات المتوقّفة مؤقتًا لا يتوفّر هذا الإعداد إلا إذا كان الاشتراك يتضمّن حاليًا SubscriptionState SUBSCRIPTION_state_PAUSE.

object (CanceledStateContext)

سياق إضافي حول الاشتراكات الملغاة لا يتوفّر هذا الإعداد إلا إذا كان الاشتراك يتضمن حاليًا SubscriptionState SUBSCRIPTION_state_CANCELED أو SUBSCRIPTION_state_EXPIRED.

object (TestPurchase)

لا يتوفّر العرض إلا إذا كانت عملية شراء الاشتراك هذه عبارة عن عملية شراء تجريبية.

enum (AcknowledgementState)

حالة الإقرار بالاشتراك.

object (ExternalAccountIdentifiers)

معرّف حساب المستخدم في الخدمة التابعة لجهة خارجية

object (SubscribeWithGoogleInfo)

الملف الشخصي للمستخدم مرتبط بعمليات الشراء التي تم إجراؤها باستخدام ميزة "اشترِك مع Google".

{
  "autoResumeTime": string
}

string (Timestamp format)

وقت استئناف الاشتراك تلقائيًا

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}

object (UserInitiatedCancellation)

ألغى المستخدم الاشتراك.

object (SystemInitiatedCancellation)

تم إلغاء الاشتراك من قِبل النظام، مثلاً بسبب مشكلة في الفوترة.

object (DeveloperInitiatedCancellation)

تم إلغاء الاشتراك من قِبل المطوّر.

object (ReplacementCancellation)

تم استبدال الاشتراك باشتراك جديد.

{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}

object (CancelSurveyResult)

المعلومات التي يقدّمها المستخدم عند إكمال عملية إلغاء الاشتراك (استطلاع حول سبب الإلغاء)

string (Timestamp format)

الوقت الذي ألغى فيه المستخدم الاشتراك وقد يظل بإمكان المستخدم الوصول إلى الاشتراك بعد هذا الوقت. استخدِم lineItems.expiry_time لتحديد ما إذا كان لا يزال بإمكان المستخدم الوصول إليه.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}

enum (CancelSurveyReason)

السبب الذي اختاره المستخدم في استطلاع أسباب الإلغاء

string

يتم الضبط فقط على CANCEL_SURVEY_REASON_OTHERS. هذا هو رد المستخدم الحر على الاستبيان.

{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

معرّف حساب المستخدم في الخدمة التابعة لجهة خارجية لا يتوفّر هذا العرض إلا إذا تم ربط الحساب كجزء من مسار شراء الاشتراك.

string

إصدار مشفَّر من رقم التعريف يرتبط بشكلٍ فريد بحساب المستخدم في تطبيقك. يجب إتاحة العرض لعمليات الشراء التالية: * في حال تم ربط الحساب كجزء من مسار شراء الاشتراك. * تم تحديده باستخدام https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid عند إجراء عملية الشراء.

string

إصدار مشفَّر من المعرّف يرتبط بشكل فريد بالملف الشخصي للمستخدم في تطبيقك. لا تظهر هذه المعلومات إلا إذا تم تحديدها باستخدام https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid عند إجراء عملية الشراء.

{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}

string

معرّف الملف الشخصي في Google للمستخدم عند شراء الاشتراك.

string

اسم الملف الشخصي للمستخدم عند شراء الاشتراك.

string

عنوان البريد الإلكتروني للمستخدم عند شراء الاشتراك.

string

الاسم المحدّد للمستخدم عند شراء الاشتراك

string

اسم عائلة المستخدم عند شراء الاشتراك.

{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}

string

معرّف المنتج الذي تم شراؤه (على سبيل المثال، "month001").

string (Timestamp format)

الوقت الذي انتهت فيه صلاحية الاشتراك أو ستنتهي صلاحيته ما لم يتم تمديد إمكانية الوصول (مثلاً، تجديد)

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

object (AutoRenewingPlan)

يتم تجديد العنصر تلقائيًا.

object (PrepaidPlan)

السلعة مُسبقة الدفع.

object (OfferDetails)

تفاصيل العرض لهذه السلعة.

object (DeferredItemReplacement)

معلومات حول استبدال السلعة المؤجلة

{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  }
}

boolean

إذا كان الاشتراك مضبوطًا على التجديد التلقائي في الوقت الحالي، مثلاً عدم إلغاء المستخدم للاشتراك

object (SubscriptionItemPriceChangeDetails)

تشير هذه السمة إلى معلومات حول آخر تغيير في سعر السلعة منذ الاشتراك في الاشتراك.

object (InstallmentPlan)

الالتزام بخطة الأقساط والمعلومات المتعلقة بخطة التجديد التلقائي

{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}

object (Money)

السعر المتكرر الجديد لعنصر الاشتراك

enum (PriceChangeMode)

يحدّد "وضع تغيير السعر" طريقة تغيير سعر الاشتراك.

enum (PriceChangeState)

الإشارة إلى التغيير في السعر حاليًا.

string (Timestamp format)

وقت التجديد الذي سيصبح فيه تغيير السعر ساريًا لدى المستخدم يخضع هذا الخيار للتغيير(لوقت مستقبلي) بسبب الحالات التي يتغيّر فيها وقت التجديد، مثل الإيقاف المؤقت. تتم تعبئة هذا الحقل فقط في حال عدم سريان تغيير السعر.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}

integer

إجمالي عدد الدفعات التي يلتزم بها المستخدم في البداية.

integer

إجمالي عدد الدفعات التي سيلتزم بها المستخدم بعد كل مدة اشتراك يعني الخيار "فارغ" أنّ خطة الأقساط ستعود إلى وضعها الطبيعي الذي يتم تجديده تلقائيًا بعد انتهاء مدة الاشتراك الأولية.

integer

إجمالي عدد الدفعات المُلتزم بها المتبقية والتي يجب دفعها في دورة التجديد هذه.

object (PendingCancellation)

وفي حال توفّرها، تكون خطة الأقساط هذه في انتظار الإلغاء. ولا يحدث الإلغاء إلا بعد أن ينتهي المستخدم من جميع الدفعات المُلتزَم بها.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

وفي حال توفّره، هذا هو الوقت الذي يُسمح بعده بإجراء عمليات شراء رصيد في خطة الدفع المُسبَق. لن تكون متوفرة في خطط الدفع المُسبق المنتهية الصلاحية.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}

string

علامات أحدث العروض المرتبطة بالعرض الترويجي ويتضمّن علامات مكتسَبة من الخطة الأساسية.

string

معرّف الخطة الأساسية. متاح لجميع الخطط الأساسية والعروض.

string

معرّف العرض الترويجي تتوفّر هذه الميزة للعروض المخفَّضة فقط.

{
  "productId": string
}

string

productId الذي سيحل محل productId الحالي.