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
}
فیلدها
publishType

enum ( PublishType )

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

نوع انتشار

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

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

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

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

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

integer

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