- משאב: OneTimeProduct
- OneTimeProductListing
- OneTimeProductTaxAndComplianceSettings
- RegionalTaxConfig
- OneTimeProductPurchaseOption
- מדינה
- OneTimeProductBuyPurchaseOption
- OneTimeProductRentPurchaseOption
- RegionalPricingAndAvailabilityConfig
- זמינות
- OneTimeProductPurchaseOptionNewRegionsConfig
- זמינות
- PurchaseOptionTaxAndComplianceSettings
- Methods
משאב: OneTimeProduct
מוצר אחד בחיוב חד-פעמי לאפליקציה.
| ייצוג ב-JSON |
|---|
{ "packageName": string, "productId": string, "listings": [ { object ( |
| שדות | |
|---|---|
packageName |
חובה. לא ניתן לשינוי. שם החבילה של האפליקציה הראשית. |
productId |
חובה. לא ניתן לשינוי. מזהה המוצר הייחודי של המוצר. ייחודי בתוך אפליקציית ההורה. מזהי מוצרים חייבים להתחיל במספר או באות קטנה, ויכולים להכיל מספרים (0-9), אותיות קטנות (a-z), קווים תחתונים (_) ונקודות (.). |
listings[] |
חובה. קבוצה של נתוני שם ותיאור מותאמים לשוק המקומי. אסור שיהיו רשומות כפולות עם אותו languageCode. |
taxAndComplianceSettings |
פרטים על מיסים ועמידה בהוראות הדין. |
purchaseOptions[] |
חובה. קבוצת אפשרויות הרכישה של המוצר הזה בחיוב חד-פעמי. |
restrictedPaymentCountries |
אופציונלי. מדינות שבהן הרכישה של המוצר בחיוב חד-פעמי הזה מוגבלת לאמצעי התשלום שרשומים באותה המדינה. אם השדה ריק, לא יוטלו הגבלות על התשלום במיקומים מסוימים. |
offerTags[] |
אופציונלי. רשימה של עד 20 תגים מותאמים אישית שצוינו למוצר בחיוב חד-פעמי זה, ומוחזרים לאפליקציה דרך ספריית החיובים. גם אפשרויות הרכישה והמבצעים של המוצר הזה יקבלו את התגים האלה בספריית החיוב. |
regionsVersion |
פלט בלבד. גרסת הגדרת האזורים ששימשה ליצירת המוצר בחיוב חד-פעמי. |
OneTimeProductListing
דף אפליקציה אזורי בחנות למוצר בחיוב חד-פעמי.
| ייצוג ב-JSON |
|---|
{ "languageCode": string, "title": string, "description": string } |
| שדות | |
|---|---|
languageCode |
חובה. השפה של דף האפליקציה הזה, כפי שהיא מוגדרת בתקן BCP-47, למשל "en-US". |
title |
חובה. שם הפריט של המוצר הזה בשפה של כרטיס המוצר. האורך המקסימלי הוא 55 תווים. |
description |
חובה. תיאור המוצר בשפה של דף האפליקציה הזה. האורך המקסימלי הוא 200 תווים. |
OneTimeProductTaxAndComplianceSettings
פרטים על מיסוי, המדיניות של Google Play ועמידה בהוראות הדין בנוגע למוצרים בחיוב חד-פעמי.
| ייצוג ב-JSON |
|---|
{ "regionalTaxConfigs": [ { object ( |
| שדות | |
|---|---|
regionalTaxConfigs[] |
הגדרת מס אזורי. |
isTokenizedDigitalAsset |
אם המוצר בחיוב חד-פעמי הזה מוצהר כמוצר שמייצג נכס דיגיטלי שהומר לטוקן. |
regionalProductAgeRatingInfos[] |
מידע על סיווג תוכן אזורי. כרגע השדה הזה נתמך רק בקוד האזור |
productTaxCategoryCode |
קוד קטגוריית המס של המוצר שיוקצה למוצר בחיוב חד-פעמי. קטגוריית המס של המוצר קובעת את שיעורי המס על עסקאות שחלים על המוצר. מידע נוסף זמין במאמר במרכז העזרה. |
RegionalTaxConfig
פרטים על מיסוי באזור גיאוגרפי מסוים.
| ייצוג ב-JSON |
|---|
{ "regionCode": string, "taxTier": enum ( |
| שדות | |
|---|---|
regionCode |
חובה. קוד האזור שההגדרה הזו חלה עליו, כפי שמוגדר בתקן ISO 3166-1 alpha-2, למשל "US". |
taxTier |
מדרגת מס כדי לציין שיעור מס מופחת. מפתחים שמוכרים חדשות, מגזינים, עיתונים, ספרים או ספרי אודיו בפורמט דיגיטלי באזורים שונים עשויים להיות זכאים לשיעורי מס מופחתים. |
eligibleForStreamingServiceTaxRate |
כדי לחייב בצורה נכונה במס מכירה מקומי וברמת המדינה בארה"ב, עליך להודיע לנו אם האפליקציה שלך מכילה מוצרי סטרימינג. השדה נתמך רק בארצות הברית. |
streamingTaxType |
כדי לגבות מיסי תקשורת או בידור בארצות הברית, צריך לבחור את קטגוריית המס המתאימה. |
OneTimeProductPurchaseOption
אפשרות רכישה אחת למוצר בחיוב חד-פעמי.
| ייצוג ב-JSON |
|---|
{ "purchaseOptionId": string, "state": enum ( |
| שדות | |
|---|---|
purchaseOptionId |
חובה. לא ניתן לשינוי. המזהה הייחודי של אפשרות הרכישה הזו. המזהה חייב להיות ייחודי במסגרת המוצר בחיוב חד-פעמי. המזהה צריך להתחיל במספר או באות קטנה, ויכול לכלול רק אותיות קטנות באנגלית (a-z), ספרות (0-9) ומקפים (-). האורך המקסימלי הוא 63 תווים. |
state |
פלט בלבד. המצב של אפשרות הרכישה, כלומר אם היא פעילה. אי אפשר לשנות את השדה הזה על ידי עדכון המשאב. במקום זאת, צריך להשתמש בנקודות הקצה הייעודיות. |
regionalPricingAndAvailabilityConfigs[] |
מידע על זמינות ותמחור לפי אזור של אפשרות הרכישה הזו. |
newRegionsConfig |
מידע על תמחור בכל מיקום חדש ש-Play תשיק בעתיד. אם לא תבחרו באפשרות הזו, אפשרות הרכישה לא תהיה זמינה באופן אוטומטי במיקומים חדשים שבהם Play יושק בעתיד. |
offerTags[] |
אופציונלי. רשימה של עד 20 תגים מותאמים אישית שצוינו לאפשרות הרכישה הזו, ומוחזרים לאפליקציה דרך ספריית החיובים. גם המבצעים של אפשרות הרכישה הזו יקבלו את התגים האלה בספריית החיוב. |
taxAndComplianceSettings |
אופציונלי. פרטים על מיסים ועמידה בהוראות הדין. |
| סוג אפשרות הרכישה. צריך להגדיר רק אחד מהם. ברשימה הבאה מפורטים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים: | |
buyOption |
אפשרות רכישה שאפשר לקנות. |
rentOption |
אפשרות רכישה להשכרה. |
| סוף השדות שמוציאים זה את זה. | |
מדינה (State)
המצב הנוכחי של אפשרות הרכישה.
| טיפוסים בני מנייה (enum) | |
|---|---|
STATE_UNSPECIFIED |
ערך ברירת המחדל, לא אמור להיות בשימוש. |
DRAFT |
אפשרות הרכישה לא זמינה למשתמשים, ומעולם לא הייתה זמינה להם. |
ACTIVE |
אפשרות הרכישה זמינה למשתמשים. |
INACTIVE |
אפשרות הרכישה לא זמינה יותר למשתמשים. |
INACTIVE_PUBLISHED |
אפשרות הרכישה לא זמינה יותר לרכישה, אבל אנחנו ממשיכים לחשוף את המבצע שלה דרך ספריית החיובים ב-Play לצורך תאימות לדור קודם. רק אפשרויות רכישה שהועברו באופן אוטומטי יכולות להיות במצב הזה. |
OneTimeProductBuyPurchaseOption
אפשרות רכישה שאפשר לקנות.
| ייצוג ב-JSON |
|---|
{ "legacyCompatible": boolean, "multiQuantityEnabled": boolean } |
| שדות | |
|---|---|
legacyCompatible |
אופציונלי. האם אפשרות הרכישה הזו תהיה זמינה בתהליכים מדור קודם של ספריית החיובים של Google Play שלא תומכים במודל של מוצרים בחיוב חד-פעמי. אפשר לסמן עד אפשרות רכישה אחת מסוג "קנייה" כתואמת לדור קודם. |
multiQuantityEnabled |
אופציונלי. אם אפשרות הרכישה הזו מאפשרת רכישה בכמות גדולה. האפשרות "כמות מרובה" מאפשרת לקונה לרכוש יותר מפריט אחד בתשלום אחד. |
OneTimeProductRentPurchaseOption
אפשרות רכישה להשכרה.
| ייצוג ב-JSON |
|---|
{ "rentalPeriod": string, "expirationPeriod": string } |
| שדות | |
|---|---|
rentalPeriod |
חובה. משך הזמן שבו למשתמש יש הרשאה. המינוי מתחיל מיידית בסיום תהליך הרכישה. מצוין בפורמט ISO 8601. |
expirationPeriod |
אופציונלי. פרק הזמן שעומד לרשות המשתמש מרגע שהוא מתחיל להשתמש בהרשאה ועד שהיא מבוטלת. מצוין בפורמט ISO 8601. |
RegionalPricingAndAvailabilityConfig
הגדרת תמחור וזמינות לפי אזור לאפשרות רכישה.
| ייצוג ב-JSON |
|---|
{ "regionCode": string, "price": { object ( |
| שדות | |
|---|---|
regionCode |
חובה. קוד האזור שההגדרה הזו חלה עליו, כפי שמוגדר בתקן ISO 3166-1 alpha-2, למשל "US". |
price |
המחיר של אפשרות הרכישה באזור שצוין. צריך להגדיר את המטבע שמקושר לאזור שצוין. |
availability |
הזמינות של אפשרות הרכישה. |
זמינות
הזמינות של אפשרות הרכישה.
| טיפוסים בני מנייה (enum) | |
|---|---|
AVAILABILITY_UNSPECIFIED |
לא צוינה זמינות. אסור להשתמש בהם. |
AVAILABLE |
אפשרות הרכישה זמינה למשתמשים. |
NO_LONGER_AVAILABLE |
אפשרות הרכישה לא זמינה יותר למשתמשים. אפשר להשתמש בערך הזה רק אם הזמינות הוגדרה בעבר כ-AVAILABLE. |
AVAILABLE_IF_RELEASED |
אפשרות הרכישה לא זמינה בהתחלה, אבל היא הופכת לזמינה באמצעות מבצע להזמנה מראש של מוצר שהושק. |
AVAILABLE_FOR_OFFERS_ONLY |
אפשרות הרכישה לא זמינה, אבל המבצעים שמקושרים אליה (למשל, מבצע צבירת נקודות של Play Points) זמינים. |
OneTimeProductPurchaseOptionNewRegionsConfig
פרטי תמחור לאזורים חדשים שבהם Play עשוי להיות מושק בעתיד.
| ייצוג ב-JSON |
|---|
{ "usdPrice": { object ( |
| שדות | |
|---|---|
usdPrice |
חובה. המחיר בדולר ארה"ב שבו יש להשתמש בכל אזור חדש שבו Play יושק. |
eurPrice |
חובה. המחיר באירו שבו ייעשה שימוש בכל אזור חדש שבו Play יושק. |
availability |
חובה. הזמינות האזורית בהגדרת האזורים החדשים. אם מגדירים את האפשרות AVAILABLE, פרטי התמחור ישמשו לכל אזור חדש ש-Play תשיק בעתיד. |
זמינות
הזמינות של הגדרת האזורים החדשים.
| טיפוסים בני מנייה (enum) | |
|---|---|
AVAILABILITY_UNSPECIFIED |
לא צוינה זמינות. אסור להשתמש בהם. |
AVAILABLE |
ההגדרה הזו תשמש בכל אזור חדש שבו Play יושק בעתיד. |
NO_LONGER_AVAILABLE |
ההגדרה לא זמינה יותר ולא תשמש לאזורים חדשים שבהם Play יושק בעתיד. אפשר להשתמש בערך הזה רק אם הזמינות הוגדרה בעבר כ-AVAILABLE. |
PurchaseOptionTaxAndComplianceSettings
פרטים על מיסוי, המדיניות של Google Play ועמידה בהוראות הדין לגבי אפשרויות רכישה של מוצרים בחיוב חד-פעמי.
| ייצוג ב-JSON |
|---|
{
"withdrawalRightType": enum ( |
| שדות | |
|---|---|
withdrawalRightType |
אופציונלי. סיווג של תוכן דיגיטלי או שירות למוצרים שמופצים למשתמשים באזורים שעומדים בדרישות. אם המדיניות לא מוגדרת, ברירת המחדל היא מידע נוסף זמין במאמר במרכז העזרה. |
Methods |
|
|---|---|
|
מחיקה של מוצר אחד או יותר בחיוב חד-פעמי. |
|
קורא מוצר אחד או יותר בחיוב חד-פעמי. |
|
יוצרת או מעדכנת מוצר אחד או יותר בחיוב חד-פעמי. |
|
מחיקת מוצר בחיוב חד-פעמי. |
|
קריאת מוצר בחיוב חד-פעמי אחד. |
|
הצגת רשימה של כל המוצרים בחיוב חד-פעמי באפליקציה נתונה. |
|
יוצרת או מעדכנת מוצר בחיוב חד-פעמי. |
קודי שגיאה
הפעולות של המשאב הזה מחזירות את קודי שגיאות ה-HTTP הבאים:
| קוד שגיאה | סיבה | תיאור | פתרון |
|---|