Method: publishers.items.publish

שולחים את הפריט לפרסום בחנות.

הפריט יישלח לבדיקה אלא אם הערך של skipReview הוא true, או שהפריט מועבר לסביבת Staging משליחה קודמת עם הערך STAGED_PUBLISH של publishType.

בקשת HTTP

POST https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:publish

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם הפריט בפורמט publishers/{publisherId}/items/{itemId}

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean
}
שדות
publishType

enum (PublishType)

אופציונלי. המאפיין הזה מאפשר לקבוע אם הפריט יפורסם מיד אחרי האישור או יועבר לסביבת Staging לפרסום בעתיד. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא DEFAULT_PUBLISH.

deployInfos[]

object (DeployInfo)

אופציונלי. מידע נוסף על הפריסה, כולל אחוז ההשקה הראשוני הרצוי. אם לא מוגדר ערך, ברירת המחדל היא הערך הנוכחי ששמור במרכז השליטה למפתחים.

skipReview

boolean

אופציונלי. האם לנסות לדלג על בדיקת הפריט. ה-API יבדוק אם הפריט עומד בדרישות, ואם נדרשת בדיקה של הפריט, הוא יחזיר שגיאת אימות. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא false.

גוף התשובה

הודעת תגובה לגבי items.publish.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState)
}
שדות
name

string

השם של הפריט שנשלח

itemId

string

פלט בלבד. המזהה של הפריט.

state

enum (ItemState)

פלט בלבד. המצב הנוכחי של השליחה.

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/chromewebstore

PublishType

סוג הפרסום שהפריט הזה יעבור אם הוא יעבור את הבדיקה.

טיפוסים בני מנייה (enum)
PUBLISH_TYPE_UNSPECIFIED ערך ברירת המחדל. זהה ל-DEFAULT_PUBLISH.
DEFAULT_PUBLISH הפריט יישלח לפרסום מיד אחרי האישור.
STAGED_PUBLISH אחרי האישור, הפריט יישמר לפרסום במועד מאוחר יותר (Staging) והמפתח יוכל לפרסם אותו.

DeployInfo

מידע על פריסה בערוץ הפצה ספציפי. משמש בבקשות לעדכון פרמטרים של פריסה.

ייצוג ב-JSON
{
  "deployPercentage": integer
}
שדות
deployPercentage

integer

חובה. אחוז הפריסה הנוכחי של ערוץ העדכונים (מספר לא שלילי בין 0 ל-100).