- משאב: מינוי
- BasePlan
- מדינה (State)
- AutoRenewingBasePlanType
- ResubscribeState
- SubscriptionProrationMode
- PrepaidBasePlanType
- TimeExtension
- InstallmentsBasePlanType
- RenewalType
- RegionalBasePlanConfig
- OtherRegionsBasePlanConfig
- SubscriptionListing
- RestrictedPaymentCountries
- שיטות
משאב: מנוי
מינוי אחד לאפליקציה.
ייצוג JSON |
---|
{ "packageName": string, "productId": string, "basePlans": [ { object ( |
שדות | |
---|---|
packageName |
בלתי משתנה. שם החבילה של אפליקציית ההורה. |
productId |
בלתי משתנה. מזהה המוצר הייחודי של המוצר. ייחודיים באפליקציית ההורה. מזהי מוצרים חייבים לכלול אותיות קטנות (a-z), מספרים (0-9), קווים תחתונים (_) ונקודות (.). הם חייבים להתחיל באות או במספר קטנות, ואורך השם צריך להיות בין 1 ל-40 (כולל). |
basePlans[] |
הקבוצה של המינויים הבסיסיים למינוי הזה. העמודה הזו מייצגת את המחירים ואת משך המינוי, אם לא חלים מבצעים אחרים. |
listings[] |
חובה. רשימת רישומים מקומיים עבור המינוי הזה. צריכה להכיל לפחות רשומה לשפת ברירת המחדל של אפליקציית ההורה. |
archived |
פלט בלבד. הוצאה משימוש: העברת המינויים לארכיון לא נתמכת. |
taxAndComplianceSettings |
פרטים לגבי מיסים ותאימות לחוק. |
restrictedPaymentCountries |
זה שינוי אופציונלי. מדינות שבהן רכישת המינוי הזה מוגבלת לאמצעי תשלום שרשומים באותה מדינה. אם השדה ריק, אין הגבלות על מיקום התשלומים. |
BasePlan
מינוי בסיסי אחד למינוי.
ייצוג JSON |
---|
{ "basePlanId": string, "state": enum ( |
שדות | |
---|---|
basePlanId |
חובה. בלתי משתנה. המזהה הייחודי של המינוי הבסיסי הזה. חייבת להיות ייחודית במסגרת המינוי, ולהתאים לתקן RFC-1034. כלומר, המזהה יכול להכיל רק אותיות קטנות (a-z), מספרים (0-9) ומקפים (-), והוא יכול להיות באורך של 63 תווים לכל היותר. |
state |
פלט בלבד. המצב של המינוי הבסיסי, כלומר האם המינוי פעיל. אפשר להפעיל או למחוק טיוטות של מינויים בסיסיים ומינויים בסיסיים שאינם פעילים. אפשר להשבית מינויים בסיסיים פעילים. אפשר לבטל מינויים בסיסיים לא פעילים. לא ניתן לשנות את השדה הזה על ידי עדכון המשאב. במקום זאת, אפשר להשתמש בנקודות הקצה הייעודיות. |
regionalConfigs[] |
מידע ספציפי לאזור בתוכנית הבסיסית הזו. |
offerTags[] |
רשימה של עד 20 תגים מותאמים אישית שצוינו למינוי הבסיסי הזה ומוחזרים לאפליקציה דרך ספריית החיובים. מבצעים למינויים במינוי הבסיסי הזה יקבלו גם את תגי המבצע האלה בספריית החיובים. |
otherRegionsConfig |
פרטי התמחור למיקומים חדשים של Play עשויים להיות זמינים בעתיד. אם פרט זה יושמט, תוכנית BasePlan לא תהיה זמינה באופן אוטומטי במיקומים חדשים ש-Play עשויה להשיק בעתיד. |
שדה איחוד base_plan_type . הסוג של המינוי הבסיסי הזה. יש להגדיר בדיוק ערך אחד. base_plan_type יכול להיות רק אחד מהבאים: |
|
autoRenewingBasePlanType |
אפשר להגדיר מתי המינוי הבסיסי יתחדש אוטומטית במרווחי זמן קבועים. |
prepaidBasePlanType |
יש להגדיר מתי המינוי הבסיסי לא יתחדש באופן אוטומטי בסוף תק��פת החיוב. |
installmentsBasePlanType |
המאפיין הזה מוגדר למינויים בסיסיים שבהם המשתמש מחויב למספר מסוים של תשלומים. |
ארץ
המצב הנוכחי של מינוי בסיסי.
טיפוסים בני מנייה (enums) | |
---|---|
STATE_UNSPECIFIED |
המצב לא צוין. |
DRAFT |
המינוי הבסיסי נמצא כרגע במצב טיוטה ולא הופעל. בשלב הזה אפשר למחוק אותה בבטחה. |
ACTIVE |
המינוי הבסיסי פעיל וזמין למנויים חדשים. |
INACTIVE |
המינוי הבסיסי לא פעיל וזמין רק למנויים קיימים. |
AutoRenewingBasePlanType
מייצג מינוי בסיסי שמתחדש אוטומטית בסוף תקופת המינוי.
ייצוג JSON |
---|
{ "billingPeriodDuration": string, "gracePeriodDuration": string, "accountHoldDuration": string, "resubscribeState": enum ( |
שדות | |
---|---|
billingPeriodDuration |
חובה. תקופת המינוי, המצוינת בפורמט ISO 8601. במרכז העזרה אפשר למצוא רשימה של תקופות חיוב מקובלות. |
gracePeriodDuration |
תקופת החסד של המינוי, שצוינה בפורמט ISO 8601. הערכים הקבילים הם P0D (אפס ימים), P3D (3 ימים), P7D (7 ימים), P14D (14 ימים) ו-P30D (30 ימים). אם לא מציינים ערך, המערכת תשתמש בערך ברירת מחדל על סמך משך התקופה הקבועה. |
accountHoldDuration |
זה שינוי אופציונלי. תקופת השהיית החשבון במסגרת המינוי, כמפורט בפורמט ISO 8601. הערכים הקבילים חייבים להיות ב-DAYS ובטווח P0D (אפס ימים) עד P30D (30 ימים). אם לא מציינים זאת, ערך ברירת המחדל הוא P30D (30 ימים). |
resubscribeState |
האם למשתמשים צריכה להיות אפשרות להירשם מחדש למינוי הבסיסי הזה בפלטפורמות של Google Play. אם לא צוין ערך, ברירת המחדל היא REROW_STATE_ACTIVE. |
prorationMode |
מצב החלק היחסי של המינוי הבסיסי קובע מה קורה כשמשתמש עובר לתוכנית הזו ממינוי בסיסי אחר. אם לא צוין, ברירת המחדל היא Charge_ON_NEXT_BILLING_DATE. |
legacyCompatible |
האם המינוי הבסיסי המתחדש תואם לאחור. המינוי הבסיסי שתומך בתאימות לאחור מוחזר על ידי השיטה שהוצאה משימוש querySkuDetailsAsync() , בספריית החיובים ב-Google Play. בכל מינוי נתון אפשר לסמן רק מינוי בסיסי אחד שמתחדש. |
legacyCompatibleSubscriptionOfferId |
מזהה מבצע מינוי שתואם לדור הקודם. מבצע המינוי בתאימות לאחור מוחזר על ידי השיטה שהוצאה משימוש querySkuDetailsAsync() , בספריית החיובים ב-Google Play. אפשר לסמן רק מבצע אחד של מינוי כמתאים מדור קודם למינוי בסיסי מתחדש נתון. כדי שאף מבצע מינוי לא יהיה תואם מדור קודם, צריך להגדיר את השדה הזה כמחרוזת ריקה. |
ResubscribeState
מצב ההרשמה מחדש למינוי הבסיסי.
טיפוסים בני מנייה (enums) | |
---|---|
RESUBSCRIBE_STATE_UNSPECIFIED |
המצב לא צוין. |
RESUBSCRIBE_STATE_ACTIVE |
התכונה 'הרשמה מחדש' פעילה. |
RESUBSCRIBE_STATE_INACTIVE |
התכונה 'הרשמה מחדש' לא פעילה. |
SubscriptionProrationMode
המצב היחסי המשמש לחידוש מינויים בסיסיים.
טיפוסים בני מנייה (enums) | |
---|---|
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED |
מצב לא מוגדר. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE |
המשתמשים יחויבו על המינוי הבסיסי החדש בסיום תקופת החיוב הנוכחית. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY |
המשתמשים יחויבו על המינוי הבסיסי החדש באופן מיידי ומלא. כל התקופה שנותרה במינוי הקיים תשמש להארכת משך הזמן של תוכנית החיוב החדשה. |
PrepaidBasePlanType
המינוי הזה מייצג מינוי בסיסי שלא מתחדש אוטומטית בסיום המינוי הבסיסי, והמשתמשים צריכים לחדש אותו באופן ידני.
ייצוג JSON |
---|
{
"billingPeriodDuration": string,
"timeExtension": enum ( |
שדות | |
---|---|
billingPeriodDuration |
חובה. תקופת המינוי, המצוינת בפורמט ISO 8601. במרכז העזרה אפשר למצוא רשימה של תקופות חיוב מקובלות. |
timeExtension |
האם למשתמשים תהיה אפשרות להאריך את המינוי הבסיסי בתשלום מראש בפלטפורמות של Google Play. אם לא צוין ערך ברירת מחדל, ערך ברירת המחדל הוא TIME_extension_ACTIVE. |
TimeExtension
הארכת זמן של מינוי בסיסי.
טיפוסים בני מנייה (enums) | |
---|---|
TIME_EXTENSION_UNSPECIFIED |
המצב לא צוין. |
TIME_EXTENSION_ACTIVE |
תוסף הזמן פעיל. המשתמשים יכולים להוסיף כסף או להאריך את המינוי בתשלום מראש. |
TIME_EXTENSION_INACTIVE |
תוסף הזמן לא פעיל. המשתמשים לא יכולים להוסיף או להאריך את המינוי בתשלום מראש. |
InstallmentsBasePlanType
הערך של מינוי בסיסי ל'תשלומים' שבו המשתמש מתחייב למספר מסוים של תשלומים.
ייצוג JSON |
---|
{ "billingPeriodDuration": string, "committedPaymentsCount": integer, "renewalType": enum ( |
שדות | |
---|---|
billingPeriodDuration |
חובה. תקופת המינוי, המצוינת בפורמט ISO 8601. במרכז העזרה אפשר למצוא רשימה של תקופות חיוב מקובלות. |
committedPaymentsCount |
חובה. מספר התשלומים שהמשתמש התחייב אליהם. |
renewalType |
חובה. סוג החידוש של המינוי הבסיסי לתשלומים. קובעת את ההתנהגות בסוף ההתחייבות הראשונית. |
gracePeriodDuration |
תקופת החסד של המינוי, שצוינה בפורמט ISO 8601. הערכים הקבילים הם P0D (אפס ימים), P3D (3 ימים), P7D (7 ימים), P14D (14 ימים) ו-P30D (30 ימים). אם לא מציינים ערך, המערכת תשתמש בערך ברירת מחדל על סמך משך התקופה הקבועה. |
accountHoldDuration |
זה שינוי אופציונלי. תקופת השהיית החשבון במסגרת המינוי, המצוינת אך ורק בימים ובפורמט ISO 8601. הערכים הקבילים הם P0D (אפס ימים) עד P30D (30 ימים). אם לא מציינים זאת, ערך ברירת המחדל הוא P30D (30 ימים). |
resubscribeState |
האם למשתמשים צריכה להיות אפשרות להירשם מחדש למינוי הבסיסי הזה בפלטפורמות של Google Play. אם לא צוין ערך, ברירת המחדל היא REROW_STATE_ACTIVE. |
prorationMode |
מצב החלק היחסי של המינוי הבסיסי קובע מה קורה כשמשתמש עובר לתוכנית הזו ממינוי בסיסי אחר. אם לא צוין, ברירת המחדל היא Charge_ON_NEXT_BILLING_DATE. |
RenewalType
סוג החידוש של המינוי הבסיסי לתשלומים. קובעת את ההתנהגות בסוף ההתחייבות הראשונית.
טיפוסים בני מנייה (enums) | |
---|---|
RENEWAL_TYPE_UNSPECIFIED |
המצב לא צוין. |
RENEWAL_TYPE_RENEWS_WITHOUT_COMMITMENT |
מתחדש מעת לעת, למשך תקופת החיוב ללא התחייבות. |
RENEWAL_TYPE_RENEWS_WITH_COMMITMENT |
המינוי יחודש עם התחייבות למשך אותו פרק זמן של המינוי הראשוני. |
RegionalBasePlanConfig
הגדרה למינוי בסיסי ספציפי לאזור.
ייצוג JSON |
---|
{
"regionCode": string,
"newSubscriberAvailability": boolean,
"price": {
object ( |
שדות | |
---|---|
regionCode |
חובה. קוד האזור שעליו חלה ההגדרה הזו, כפי שהוגדר בתקן ISO 3166-2, לדוגמה "US". |
newSubscriberAvailability |
אם המינוי הבסיסי באזור שצוין זמין למנויים חדשים. אם הערך הזה מוגדר כ-False, לא יבוטל המינוי של מנויים קיימים. אם לא תציינו, ברירת המחדל תהיה FALSE. |
price |
המחיר של המינוי הבסיסי באזור שצוין. צריך להגדיר אם המינוי הבסיסי זמין למנויים חדשים. חובה להגדיר את המטבע שמקושר לאזור שצוין. |
OtherRegionsBasePlanConfig
פרטי התמחור למיקומים חדשים שבהם עשויה להיות ההשקה של Play.
ייצוג JSON |
---|
{ "usdPrice": { object ( |
שדות | |
---|---|
usdPrice |
חובה. המחיר בדולר ארה"ב לשימוש במיקומים חדשים שבהם תת��צע השקה של Play. |
eurPrice |
חובה. המחיר באירו לשימוש במיקומים חדשים ש-Play עשויה להשיק בהם. |
newSubscriberAvailability |
האם המינוי הבסיסי זמין למנויים חדשים במיקומים חדשים שבהם אפשר להשיק את Play. אם לא תציינו, ברירת המחדל תהיה FALSE. |
SubscriptionListing
המטא-נתונים של המינוי שגלויים לצרכנים.
ייצוג JSON |
---|
{ "languageCode": string, "title": string, "benefits": [ string ], "description": string } |
שדות | |
---|---|
languageCode |
חובה. השפה של דף האפליקציה הזה, כפי שהוגדרה על ידי BCP-47, לדוגמה: 'en-US'. |
title |
חובה. הכותרת של המינוי הזה בשפה של דף האפליקציה הזה. טקסט פשוט. |
benefits[] |
רשימה של הטבות שמוצגת למשתמש בפלטפורמות כמו חנות Play ותהליכי שחזור בשפה של דף האפליקציה הזה. טקסט פשוט. רשימה ממוינת של ארבע הטבות לכל היותר. |
description |
תיאור המינוי בשפה של דף האפליקציה הזה. האורך המקסימלי הוא 80 תווים. טקסט פשוט. |
RestrictedPaymentCountries
מדינות שבהן רכישת המוצר הזה מוגבלת לאמצעי תשלום שרשומים באותה מדינה. אם השדה ריק, אין הגבלות על מיקום התשלומים.
ייצוג JSON |
---|
{ "regionCodes": [ string ] } |
שדות | |
---|---|
regionCodes[] |
חובה. קודי אזורים שעליהם צריך להטיל הגבלות תשלום, כפי שמוגדר בתקן ISO 3166-2, למשל "US". |
שיטות |
|
---|---|
(deprecated) |
הוצאה משימוש: העברת המינויים לארכיון לא נתמכת. |
|
קריאה של מינוי אחד או יותר. |
|
מעדכן קבוצה של מינויים. |
|
ייווצר מינוי חדש. |
|
מחיקת מינוי. |
|
קורא מינוי יחיד. |
|
הצגת כל המינויים באפליקציה נתונה. |
|
עדכון מינוי קיים. |