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,
  "blockOnWarnings": boolean
}
שדות
publishType

enum (PublishType)

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

object (DeployInfo)

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

boolean

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

boolean

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

גוף התשובה

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

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

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

string

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

string

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

enum (ItemState)

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

object (WarningsInfo)

פלט בלבד. נמצאו אזהרות לא חוסמות במהלך הבקשה.

היקפי הרשאות

נדרש היקף ההרשאות הבא של 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).

WarningsInfo

הודעה שמכילה פרטים על אזהרות שנתקלו בהן במהלך הפעולה items.publish.

ייצוג ב-JSON 
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
שדות
warnings[]

object (Warning)

כל האזהרות שנתקלו בהן במהלך הבקשה.

אזהרה

מייצג אזהרה אחת שנתקלה במהלך הבקשה.

ייצוג ב-JSON 
{
  "reason": string,
  "description": string
}
שדות
reason

string

הסיבה לאזהרה. זהו ערך קבוע שמזהה את הסיבה הקרובה לאזהרה.
description

string

תיאור של האזהרה. מפתחים צריכים להשתמש בהודעה הזו כדי להבין את האזהרה ולבצע את הפעולה המתאימה לפתרון הבעיה.