Method: publishers.items.publish

مطلب مورد نظر را برای انتشار در فروشگاه ارسال کنید.

این مورد برای بررسی ارسال خواهد شد، مگر اینکه skipReview روی true تنظیم شده باشد، یا اینکه مورد از ارسال قبلی با publishType تنظیم شده روی STAGED_PUBLISH مرحله‌بندی شده باشد.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
name

string

الزامی. نام آیتم در فرم publishers/{publisherId}/items/{itemId}

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
فیلدها
publishType

enum ( PublishType )

اختیاری. از این گزینه برای کنترل انتشار فوری مطلب پس از تأیید یا آماده‌سازی آن برای انتشار در آینده استفاده کنید. در صورت عدم تنظیم، مقدار پیش‌فرض 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

نوع انتشار

در صورت قبولی در مرحله بررسی، نوع انتشار این مورد متعاقباً اعلام خواهد شد.

انوم‌ها
PUBLISH_TYPE_UNSPECIFIED مقدار پیش‌فرض. این همان DEFAULT_PUBLISH است.
DEFAULT_PUBLISH اثر ارسالی بلافاصله پس از تایید منتشر خواهد شد.
STAGED_PUBLISH پس از تأیید، ارسال، مرحله‌بندی شده و سپس می‌تواند توسط توسعه‌دهنده منتشر شود.

اطلاعات استقرار

اطلاعات استقرار برای یک کانال انتشار خاص. در درخواست‌ها برای به‌روزرسانی پارامترهای استقرار استفاده می‌شود.

نمایش JSON 
{
  "deployPercentage": integer
}
فیلدها
deployPercentage

integer

الزامی. درصد استقرار فعلی برای کانال انتشار (عدد غیرمنفی بین ۰ تا ۱۰۰).

اطلاعات هشدارها

پیامی حاوی جزئیات هشدارهای مواجه شده در طول items.publish.

نمایش JSON 
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
فیلدها
warnings[]

object ( Warning )

تمام هشدارهایی که در طول درخواست با آنها مواجه شدید.

هشدار

نشان دهنده یک هشدار واحد است که در طول درخواست با آن مواجه شده‌اید.

نمایش JSON 
{
  "reason": string,
  "description": string
}
فیلدها
reason

string

دلیل هشدار. این یک مقدار ثابت است که علت تقریبی هشدار را مشخص می‌کند.

description

string

شرح هشدار. توسعه‌دهندگان باید از این پیام برای درک هشدار و انجام اقدامات مناسب برای حل مشکل استفاده کنند.