REST Resource: monetization.onetimeproducts

منبع: OneTimeProduct

یک محصول یکبار مصرف برای یک برنامه.

نمایندگی JSON 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
فیلدها
packageName

string

مورد نیاز. تغییرناپذیر. نام بسته برنامه والد.

productId

string

مورد نیاز. تغییرناپذیر. شناسه محصول منحصر به فرد محصول. منحصر به فرد در برنامه والد. شناسه محصول باید با یک عدد یا حرف کوچک شروع شود و می تواند شامل اعداد (0-9)، حروف کوچک (az)، زیرخط (_) و نقطه (.) باشد.

listings[]

object ( OneTimeProductListing )

مورد نیاز. مجموعه ای از داده های عنوان و توضیحات محلی شده. نباید ورودی های تکراری با همان زبان کد داشته باشد.

taxAndComplianceSettings

object ( OneTimeProductTaxAndComplianceSettings )

جزئیات در مورد مالیات و انطباق قانونی.

purchaseOptions[]

object ( OneTimeProductPurchaseOption )

مورد نیاز. مجموعه گزینه های خرید این محصول یکبار مصرف.

restrictedPaymentCountries

object ( RestrictedPaymentCountries )

اختیاری. کشورهایی که خرید این محصول یکبار مصرف محدود به روش های پرداخت ثبت شده در همان کشور است. در صورت خالی بودن، هیچ محدودیتی در محل پرداخت اعمال نمی شود.

offerTags[]

object ( OfferTag )

اختیاری. فهرست حداکثر 20 برچسب سفارشی که برای این محصول یکبار مصرف مشخص شده است و از طریق کتابخانه صورتحساب به برنامه بازگردانده شده است. گزینه های خرید و پیشنهادات برای این محصول نیز این برچسب ها را در کتابخانه صورتحساب دریافت خواهند کرد.

regionsVersion

object ( RegionsVersion )

فقط خروجی نسخه پیکربندی مناطقی که برای تولید محصول یکبار مصرف استفاده شد.

OneTimeProductListing

فهرست فروشگاه منطقه ای برای یک محصول یکبار مصرف.

نمایندگی JSON 
{
  "languageCode": string,
  "title": string,
  "description": string
}
فیلدها
languageCode

string

مورد نیاز. زبان این فهرست، همانطور که توسط BCP-47 تعریف شده است، به عنوان مثال، "en-US".

title

string

مورد نیاز. عنوان این محصول به زبان این لیست است. حداکثر طول 55 کاراکتر است.

description

string

مورد نیاز. توضیحات این محصول به زبان این لیست است. حداکثر طول 200 کاراکتر است.

OneTimeProductTaxAndComplianceSettings

جزئیات مربوط به مالیات، خط‌مشی Google Play و انطباق قانونی برای محصولات یکبار مصرف.

نمایندگی JSON 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
فیلدها
regionalTaxConfigs[]

object ( RegionalTaxConfig )

پیکربندی مالیات منطقه ای

isTokenizedDigitalAsset

boolean

آیا این محصول یکبار مصرف به عنوان محصولی که نشان دهنده دارایی دیجیتالی توکن شده است، اعلام شده است یا خیر.

RegionalTaxConfig

جزئیات در مورد مالیات در یک منطقه جغرافیایی معین.

نمایندگی JSON 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
فیلدها
regionCode

string

مورد نیاز. کد منطقه ای این پیکربندی، همانطور که توسط ISO 3166-2 تعریف شده است، به عنوان مثال "US".

taxTier

enum ( TaxTier )

ردیف مالیاتی برای تعیین نرخ مالیات کاهش یافته. توسعه دهندگانی که اخبار دیجیتال، مجلات، روزنامه ها، کتاب ها یا کتاب های صوتی را در مناطق مختلف می فروشند، ممکن است واجد شرایط کاهش نرخ مالیات باشند.

بیشتر بدانید .

eligibleForStreamingServiceTaxRate

boolean

باید به ما بگویید که آیا برنامه شما حاوی محصولات پخش جریانی است تا مالیات فروش محلی و ایالتی ایالات متحده را به درستی دریافت کنیم. فیلد فقط در ایالات متحده پشتیبانی می شود.

streamingTaxType

enum ( StreamingTaxType )

برای جمع آوری مالیات ارتباطات یا تفریح در ایالات متحده، دسته مالیاتی مناسب را انتخاب کنید.

بیشتر بدانید .

OneTimeProductPurchaseOption

یک گزینه خرید واحد برای یک محصول یک بار مصرف.

نمایندگی JSON 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
فیلدها
purchaseOptionId

string

مورد نیاز. تغییرناپذیر. شناسه منحصر به فرد این گزینه خرید. باید در محصول یکبار مصرف منحصر به فرد باشد. باید با یک عدد یا حرف کوچک شروع شود و فقط شامل حروف کوچک (az)، اعداد (0-9) و خط فاصله (-) باشد. حداکثر طول 63 کاراکتر است.

state

enum ( State )

فقط خروجی وضعیت گزینه خرید، یعنی فعال بودن آن. این فیلد را نمی توان با به روز رسانی منبع تغییر داد. به جای آن از نقاط پایانی اختصاصی استفاده کنید.

regionalPricingAndAvailabilityConfigs[]

object ( RegionalPricingAndAvailabilityConfig )

اطلاعات قیمت منطقه ای و در دسترس بودن این گزینه خرید.

newRegionsConfig

object ( OneTimeProductPurchaseOptionNewRegionsConfig )

اطلاعات قیمت برای هر مکان جدیدی که Play ممکن است در آینده راه اندازی شود. اگر حذف شود، گزینه خرید به طور خودکار در مکان‌های جدیدی که Play در آینده راه اندازی می‌شود در دسترس نخواهد بود.

offerTags[]

object ( OfferTag )

اختیاری. فهرست حداکثر 20 برچسب سفارشی که برای این گزینه خرید مشخص شده است و از طریق کتابخانه صورتحساب به برنامه بازگردانده شده است. پیشنهادهای این گزینه خرید نیز این برچسب‌ها را در کتابخانه صورت‌حساب دریافت خواهند کرد.

taxAndComplianceSettings

object ( PurchaseOptionTaxAndComplianceSettings )

اختیاری. جزئیات در مورد مالیات و انطباق قانونی.

فیلد اتحادیه purchase_option_type . نوع این گزینه خرید. دقیقاً یکی باید تنظیم شود. purchase_option_type فقط می تواند یکی از موارد زیر باشد:
buyOption

object ( OneTimeProductBuyPurchaseOption )

گزینه خرید قابل خرید.

rentOption

object ( OneTimeProductRentPurchaseOption )

یک گزینه خرید که می توان آن را اجاره کرد.

ایالت

وضعیت فعلی گزینه خرید.

Enums
STATE_UNSPECIFIED مقدار پیش فرض، هرگز نباید استفاده شود.
DRAFT گزینه خرید هرگز در دسترس کاربران نبوده و نبوده است.
ACTIVE گزینه خرید در دسترس کاربران است.
INACTIVE گزینه خرید دیگر در دسترس کاربران نیست.
INACTIVE_PUBLISHED گزینه خرید دیگر برای خرید در دسترس نیست، اما ما همچنان به افشای پیشنهاد آن از طریق کتابخانه صورت‌حساب Play برای سازگاری به عقب ادامه می‌دهیم. فقط گزینه‌های خرید انتقال خودکار می‌توانند در این حالت باشند.

گزینه OneTimeProductBuyPurchase

گزینه خرید قابل خرید.

نمایندگی JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
فیلدها
legacyCompatible

boolean

اختیاری. آیا این گزینه خرید در جریان‌های PBL قدیمی که از مدل محصولات یکبار مصرف پشتیبانی نمی‌کنند در دسترس خواهد بود یا خیر.

حداکثر یک گزینه خرید "خرید" را می توان به عنوان سازگار با عقب علامت گذاری کرد.

multiQuantityEnabled

boolean

اختیاری. آیا این گزینه خرید امکان چند مقدار را می دهد یا خیر. چندتایی به خریدار اجازه می دهد تا بیش از یک کالا را در یک تسویه حساب خریداری کند.

OneTimeProductRentPurchaseOption

یک گزینه خرید که می توان آن را اجاره کرد.

نمایندگی JSON 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
فیلدها
rentalPeriod

string

مورد نیاز. مدت زمانی که یک کاربر حق دارد. با تکمیل جریان خرید شروع می شود. در قالب ISO 8601 مشخص شده است.

expirationPeriod

string

اختیاری. مدت زمانی که کاربر پس از شروع مصرف حق دارد قبل از ابطال آن. در قالب ISO 8601 مشخص شده است.

RegionalPricingAndAvailabilityConfig

قیمت منطقه ای و پیکربندی در دسترس بودن برای گزینه خرید.

نمایندگی JSON 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
فیلدها
regionCode

string

مورد نیاز. کد منطقه ای این پیکربندی همانطور که توسط ISO 3166-2 تعریف شده است، به عنوان مثال، "US".

price

object ( Money )

قیمت گزینه خرید در منطقه مشخص شده. باید به واحد پولی که به منطقه مشخص شده مرتبط است تنظیم شود.

availability

enum ( Availability )

در دسترس بودن گزینه خرید

در دسترس بودن

در دسترس بودن گزینه خرید

Enums
AVAILABILITY_UNSPECIFIED در دسترس بودن نامشخص نباید استفاده شود.
AVAILABLE گزینه خرید در دسترس کاربران است.
NO_LONGER_AVAILABLE گزینه خرید دیگر در دسترس کاربران نیست. این مقدار فقط در صورتی قابل استفاده است که در دسترس بودن قبلاً به عنوان AVAILABLE تنظیم شده باشد.
AVAILABLE_IF_RELEASED گزینه خرید در ابتدا در دسترس نیست، اما از طریق یک پیشنهاد پیش‌سفارش منتشر شده در دسترس است.

OneTimeProductPurchaseOptionNewRegionsConfig

اطلاعات قیمت برای هر منطقه جدیدی که Play ممکن است در آینده راه اندازی شود.

نمایندگی JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
فیلدها
usdPrice

object ( Money )

مورد نیاز. قیمت به دلار برای استفاده برای هر منطقه جدیدی که Play ممکن است در آن راه اندازی شود.

eurPrice

object ( Money )

مورد نیاز. قیمت به یورو برای استفاده برای هر منطقه جدیدی که Play ممکن است در آن راه اندازی شود.

availability

enum ( Availability )

مورد نیاز. در دسترس بودن منطقه ای برای پیکربندی مناطق جدید. وقتی روی AVAILABLE تنظیم شود، اطلاعات قیمت برای هر منطقه جدیدی که Play در آینده راه اندازی می شود استفاده می شود.

در دسترس بودن

در دسترس بودن پیکربندی مناطق جدید.

Enums
AVAILABILITY_UNSPECIFIED در دسترس بودن نامشخص نباید استفاده شود.
AVAILABLE این پیکربندی برای هر منطقه جدیدی که Play در آینده راه اندازی شود استفاده خواهد شد.
NO_LONGER_AVAILABLE این پیکربندی دیگر در دسترس نیست و برای هیچ منطقه جدیدی که Play در آینده راه اندازی می شود استفاده نخواهد شد. این مقدار فقط در صورتی قابل استفاده است که در دسترس بودن قبلاً به عنوان AVAILABLE تنظیم شده باشد.

PurchaseOptionTaxAndComplianceSettings

جزئیات مربوط به مالیات، خط‌مشی Google Play و انطباق قانونی برای گزینه‌های خرید یک‌باره محصول.

نمایندگی JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
فیلدها
withdrawalRightType

enum ( WithdrawalRightType )

اختیاری. محتوای دیجیتال یا طبقه بندی خدمات برای محصولات توزیع شده بین کاربران در مناطق واجد شرایط.

اگر تنظیم نشود، WITHDRAWAL_RIGHT_DIGITAL_CONTENT پیش‌فرض است.

برای اطلاعات بیشتر به مقاله مرکز راهنمایی مراجعه کنید.

روش ها

batchDelete

 یک یا چند محصول یکبار مصرف را حذف می کند.

batchGet

 یک یا چند محصول یک بار مصرف را می خواند.

batchUpdate

 یک یا چند محصول یکبار مصرف ایجاد یا به روز می کند.

delete

 یک محصول یکبار مصرف را حذف می کند.

get

 یک محصول یکبار مصرف را می خواند.

list

 همه محصولات یکبار مصرف را در یک برنامه مشخص فهرست می کند.

patch

 یک محصول یکبار مصرف ایجاد یا به روز می کند.