Method: publishers.items.publish

أرسِل العنصر المطلوب نشره في المتجر.

سيتم إرسال العنصر للمراجعة ما لم يتم ضبط skipReview على "صحيح"، أو إذا تم إعداد العنصر من عملية إرسال سابقة تم فيها ضبط publishType على STAGED_PUBLISH.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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

اختياريّ. تحديد ما إذا كان سيتم محاولة تخطّي مراجعة العنصر. ستتحقّق واجهة برمجة التطبيقات مما إذا كان المنتج مؤهَّلاً وستعرض خطأ في التحقّق إذا كان المنتج يتطلّب مراجعة. يتم ضبط القيمة تلقائيًا على false في حال عدم ضبطها.
blockOnWarnings

boolean

اختياريّ. عند ضبط القيمة على "صحيح"، سيتعذّر تنفيذ الطلب إذا ظهرت أي تحذيرات أثناء عملية التحقّق، وسيتم تضمين التفاصيل في 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

نوع النشر الذي سيتبعه هذا العنصر إذا اجتاز عملية المراجعة

عمليات التعداد
PUBLISH_TYPE_UNSPECIFIED القيمة التلقائية وهي القيمة نفسها لـ DEFAULT_PUBLISH.
DEFAULT_PUBLISH سيتم نشر المحتوى فور الموافقة عليه.
STAGED_PUBLISH بعد الموافقة على الطلب، سيتم إعداده للنشر ويمكن للمطوّر نشره بعد ذلك.

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

وصف للتحذير، ويجب أن يستخدم المطوّرون هذه الرسالة لفهم التحذير واتّخاذ الإجراء المناسب لحلّ المشكلة.