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 )

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

regionsVersion

object ( RegionsVersion )

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

لیست محصولات یک‌بارمصرف

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

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

string

الزامی. زبان این فهرست، طبق تعریف BCP-47، مثلاً "en-US".

title

string

الزامی. عنوان این محصول به زبان این آگهی. حداکثر طول ۵۵ کاراکتر.

description

string

الزامی. توضیحات این محصول به زبان این آگهی. حداکثر طول ۲۰۰ کاراکتر.

تنظیمات OneTimeProductTaxAndCompliance

جزئیات مربوط به مالیات، سیاست گوگل پلی و انطباق قانونی با قوانین مربوط به محصولات یکبار مصرف.

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

object ( RegionalTaxConfig )

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

isTokenizedDigitalAsset

boolean

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

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

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

نمایش 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 )

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

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

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

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

نمایش 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 )

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

taxAndComplianceSettings

object ( PurchaseOptionTaxAndComplianceSettings )

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

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

object ( OneTimeProductBuyPurchaseOption )

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

rentOption

object ( OneTimeProductRentPurchaseOption )

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

ایالت

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

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

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

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

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

boolean

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

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

multiQuantityEnabled

boolean

اختیاری. آیا این گزینه خرید امکان خرید چند عددی را فراهم می‌کند؟ گزینه خرید چند عددی به خریدار اجازه می‌دهد بیش از یک کالا را در یک مرحله پرداخت خریداری کند.

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

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

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

string

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

expirationPeriod

string

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

پیکربندی قیمت‌گذاری و دسترسی منطقه‌ای

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

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

string

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

price

object ( Money )

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

availability

enum ( Availability )

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

در دسترس بودن

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

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

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

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

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

object ( Money )

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

eurPrice

object ( Money )

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

availability

enum ( Availability )

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

در دسترس بودن

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

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

تنظیمات گزینه خرید، مالیات و انطباق

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

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

enum ( WithdrawalRightType )

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

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

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

روش‌ها

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

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

list

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

patch

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

کدهای خطا

عملیات این منبع، کدهای خطای HTTP زیر را برمی‌گرداند:

کد خطا دلیل وضوح تصویر
5xx خطای عمومی در سرور گوگل پلی. درخواست خود را دوباره امتحان کنید.

اگر مشکل همچنان ادامه داشت، با مدیر حساب Google Play خود تماس بگیرید یا درخواست پشتیبانی ارسال کنید. داشبورد وضعیت Play را برای هرگونه قطعی شناخته شده بررسی کنید.

409 خطای به‌روزرسانی همزمان.

تلاشی برای به‌روزرسانی شیء در حال به‌روزرسانی صورت گرفته است. برای مثال، یک خرید با فراخوانی متد acknowledgePurchase() از کتابخانه‌ی صورتحساب Play و با فراخوانی همزمان purchases.products.acknowledge از API توسعه‌دهنده‌ی Play، تأیید می‌شود.

 درخواست خود را دوباره امتحان کنید.