- בקשת HTTP
- פרמטרים של הנתיב
- גוף הבקשה
- גוף התגובה
- היקפי הרשאות
- UpdateOneTimeProductOfferStateRequest
- CancelOneTimeProductOfferRequest
- DeactivateOneTimeProductOfferRequest
- כדאי לנסות!
עדכון קבוצה של מצבי מוצרים בחיוב חד-פעמי.
בקשת HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של הנתיב
| פרמטרים | |
|---|---|
packageName |
חובה. האפליקציה הראשית (שם החבילה) של המוצרים המעודכנים בחיוב חד-פעמי. |
productId |
חובה. מזהה המוצר הראשי בחיוב חד-פעמי, אם כל המבצעים המעודכנים שייכים לאותו מוצר בחיוב חד-פעמי. אם חבילת העדכונים הזו כוללת כמה מוצרים בחיוב חד-פעמי, צריך להגדיר את השדה הזה בתור "-". |
purchaseOptionId |
חובה. המזהה של אפשרות הרכישה הראשית, אם כל המוצרים המעודכנים שייכים לאותה אפשרות רכישה. אם חבילת העדכונים הזו כוללת כמה אפשרויות רכישה, צריך להגדיר את השדה הזה כ-"-". |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
|---|
{
"requests": [
{
object ( |
| שדות | |
|---|---|
requests[] |
חובה. רשימת בקשות העדכון, עד 100 פריטים. כל בקשה צריכה לעדכן מוצר אחר. |
גוף התשובה
הודעת התגובה ל-offers.batchUpdateStates.
אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
|---|
{
"oneTimeProductOffers": [
{
object ( |
| שדות | |
|---|---|
oneTimeProductOffers[] |
הרשימה המעודכנת של המוצרים בחיוב חד-פעמי, באותו סדר כמו בבקשה. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/androidpublisher
UpdateOneTimeProductOfferStateRequest
הודעת בקשה לעדכון הסטטוס של מוצר בחיוב חד-פעמי.
| ייצוג ב-JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "activateOneTimeProductOfferRequest": { object ( |
| שדות | |
|---|---|
| סוג המעבר בין המצבים שצריך להחיל. צריך להגדיר בדיוק אחד. ברשימה הבאה מפורטים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים: | |
activateOneTimeProductOfferRequest |
מפעיל מבצע. אחרי שמפעילים את המבצע, הוא זמין למשתמשים כל עוד הם עומדים בתנאים שלו. |
cancelOneTimeProductOfferRequest |
ביטול מבצע. אחרי שמבטלים את המבצע, הוא לא זמין למשתמשים. כל ההזמנות בהמתנה שקשורות למבצע הזה יבוטלו. המעבר הזה בין המצבים ספציפי להזמנות מראש. |
deactivateOneTimeProductOfferRequest |
השבתת מבצע. אחרי שמשביתים את המבצע, הוא לא זמין יותר למשתמשים. המעבר הזה בין המצבים הוא ספציפי למבצעים של הנחות ופרסים במשחקים. |
| סוף השדות שמוציאים זה את זה. | |
CancelOneTimeProductOfferRequest
הודעת בקשה ל-offers.cancel.
| ייצוג ב-JSON |
|---|
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string,
"latencyTolerance": enum ( |
| שדות | |
|---|---|
packageName |
חובה. האפליקציה הראשית (שם החבילה) של המוצר שרוצים לבטל. |
productId |
חובה. המזהה הראשי של המוצר בחיוב חד-פעמי של המוצר שרוצים לבטל. |
purchaseOptionId |
חובה. אפשרות הרכישה הראשית (המזהה) של המוצר שרוצים לבטל. |
offerId |
חובה. המזהה של המוצר שרוצים לבטל. |
latencyTolerance |
אופציונלי. הטולרנטיות לזמן הטעינה בהפצת העדכון הזה. ברירת המחדל היא רגישות לזמן הטעינה. |
DeactivateOneTimeProductOfferRequest
הודעת בקשה ל-offers.deactivate.
| ייצוג ב-JSON |
|---|
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string,
"latencyTolerance": enum ( |
| שדות | |
|---|---|
packageName |
חובה. האפליקציה הראשית (שם החבילה) של המוצר שרוצים להשבית. |
productId |
חובה. המזהה הראשי של המוצר בחיוב חד-פעמי של המוצר שרוצים להשבית. |
purchaseOptionId |
חובה. אפשרות הרכישה הראשית (המזהה) של המוצר שרוצים להשבית. |
offerId |
חובה. מזהה המבצע שרוצים להשבית. |
latencyTolerance |
אופציונלי. הטולרנטיות לזמן הטעינה בהפצת העדכון הזה. ברירת המחדל היא רגישות לזמן הטעינה. |