REST Resource: deployments.configs

ทรัพยากร: การกำหนดค่า

การกำหนดค่าของการทำให้ใช้งานได้

การแสดง JSON 
{
  "name": string,
  "title": string,
  "description": string,
  "defaultUpdateDescription": {
    object (UpdateDescription)
  },
  "localizedUpdateDescriptions": [
    {
      object (LocalizedUpdateDescription)
    }
  ],
  "urgencyMode": enum (UrgencyMode),
  "scheduledInstallDelay": enum (ScheduledInstallDelay),
  "wifiOnlyTime": enum (WifiOnlyTime),
  "updateMaintenanceWindow": {
    object (TimeWindow)
  },
  "packageSizeAwareBatteryThreshold": boolean,
  "offPeakUpdate": {
    object (OffPeakUpdate)
  },
  "countryRestriction": {
    object (IncludeExclude)
  },
  "mobileNetworkRestriction": {
    object (IncludeExclude)
  },
  "deviceBuildPropertyRestriction": {
    object (IncludeExclude)
  },
  "mobileNetworkCarrierRestriction": {
    object (IncludeExclude)
  },
  "updateRequiredSetup": boolean,
  "minimalSpaceRequired": enum (SpaceNeed),
  "immediateRelease": boolean,
  "rolloutSteps": [
    {
      object (RolloutStep)
    }
  ],
  "securityUpdate": boolean,
  "details": {
    object (ConfigDetails)
  },
  "allowEncryptedScheduledInstall": boolean,
  "reminderDialogSettings": {
    object (ReminderDialogSettings)
  }
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อของการกำหนดค่า โปรดทราบว่านี่คือตัวระบุที่ไม่ซ้ำกันสำหรับออบเจ็กต์ Config รายการ และเซิร์ฟเวอร์จะสร้างเมื่อมีการสร้าง Config ใหม่
title

string

ไม่บังคับ ชื่อของการกำหนดค่า
description

string

ไม่บังคับ คำอธิบายของการกำหนดค่า
defaultUpdateDescription

object (UpdateDescription)

ต้องระบุ ข้อความ UI เริ่มต้นที่ใช้เมื่อภาษาของอุปกรณ์ไม่ตรงกับภาษาที่ระบุไว้ใน localizedUpdateDescriptions
localizedUpdateDescriptions[]

object (LocalizedUpdateDescription)

ไม่บังคับ รายการคำอธิบายอัปเดตที่แปลแล้ว ซึ่งจะมีลำดับความสำคัญสูงกว่า defaultUpdateDescription หากรายการใดรายการหนึ่งตรงกับภาษาของอุปกรณ์
urgencyMode

enum (UrgencyMode)

ไม่บังคับ ความเร่งด่วนของการอัปเดตซึ่งจะกำหนดวิธีการแจ้งให้ผู้ใช้ทราบ หากไม่ระบุ ระบบจะใช้ MANDATORY ตามค่าเริ่มต้น
scheduledInstallDelay

enum (ScheduledInstallDelay)

ไม่บังคับ หน่วงเวลาซึ่งกำหนดเวลาการอัปเดตสำหรับการติดตั้งข้ามคืน ค่าเริ่มต้นคือ NEVER หากไม่ระบุ
wifiOnlyTime

enum (WifiOnlyTime)

ไม่บังคับ ตั้งค่าเริ่มต้นเป็น SEVEN_DAYS หากปล่อยไว้เป็น WIFI_ONLY_TIME_UNSPECIFIED

หมายเหตุ: ระบบจะตั้งค่านี้เป็น FOREVER หาก urgencyMode เป็น RECOMMENDED
updateMaintenanceWindow

object (TimeWindow)

ไม่บังคับ กรอบเวลาการติดตั้งสำหรับ OTA
packageSizeAwareBatteryThreshold

boolean

ไม่บังคับ การอัปเดตควรมีเกณฑ์ของแบตเตอรี่ในการติดตั้งแตกต่างกันไปตามขนาดหรือไม่
offPeakUpdate

object (OffPeakUpdate)

ไม่บังคับ ออบเจ็กต์การอัปเดตในช่วงที่ไม่มีการอัปเดตสูงสุด
countryRestriction

object (IncludeExclude)

ไม่บังคับ ประเทศที่รวม/ยกเว้นที่เป็นไปได้
mobileNetworkRestriction

object (IncludeExclude)

ไม่บังคับ เครือข่ายมือถือที่เป็นไปได้ซึ่งรวมไว้/ยกเว้นซึ่งระบุโดยรหัส mcc/mnc โปรดทราบว่าต้องใช้ของ mobileNetworkCarrierRestriction เท่านั้น ไม่สามารถตั้งค่าทั้งสองฟิลด์พร้อมกัน
deviceBuildPropertyRestriction

object (IncludeExclude)

ไม่บังคับ ข้อจํากัดพร็อพเพอร์ตี้บิลด์ของอุปกรณ์ที่รวม/ยกเว้นที่เป็นไปได้
mobileNetworkCarrierRestriction

object (IncludeExclude)

ไม่บังคับ ผู้ให้บริการเครือข่ายมือถือที่เป็นไปได้ที่รวมไว้/ยกเว้น โปรดทราบว่าต้องใช้ของ mobileNetworkRestriction เท่านั้น ไม่สามารถตั้งค่าทั้งสองฟิลด์พร้อมกัน

หากต้องการดูการแมป โปรดดูรหัสประเทศของอุปกรณ์เคลื่อนที่และรหัสเครือข่ายมือถือ
updateRequiredSetup

boolean

ไม่บังคับ ระบุว่าจำเป็นต้องมีการอัปเดตหรือไม่ในระหว่างวิซาร์ดการตั้งค่า ค่าเริ่มต้นคือ false
minimalSpaceRequired

enum (SpaceNeed)

ไม่บังคับ ความต้องการพื้นที่น้อยที่สุด เมื่อค่าเป็น UNSPECIFIED เซิร์ฟเวอร์จะไม่ตั้งค่าข้อจำกัด ต้องใช้บริการ Google Play 6.1.11 ขึ้นไป
immediateRelease

boolean

ไม่บังคับ ต้องระบุ immediateRelease หรือ rolloutSteps อย่างน้อย 1 รายการ ควรเผยแพร่การอัปเดตทันทีหรือไม่ หากเป็นจริง ก็ไม่ควรตั้งค่า rolloutSteps
rolloutSteps[]

object (RolloutStep)

ไม่บังคับ ต้องระบุ rolloutSteps หรือ immediateRelease อย่างน้อย 1 รายการ RolloutSteps ต้องเรียงตามลำดับ โดยทั้ง time_ms และเศษส่วนไม่ควรลดลง ขั้นตอนสุดท้ายควรมีเศษส่วน == 100
securityUpdate

boolean

ไม่บังคับ ทําเครื่องหมายการอัปเดตเป็นการอัปเดตความปลอดภัย ซึ่งจะส่งไปยังอุปกรณ์เพื่อประสานงานในการแสดงข้อความอัปเดตที่ถูกต้อง กล่าวคือ แสดงข้อความ "กำลังใช้การอัปเดตความปลอดภัย" แทน "กำลังใช้การอัปเดตระบบ" ต้องใช้ API ระดับ 22 ขึ้นไป และบริการ Google Play 9.4 ขึ้นไป
details

object (ConfigDetails)

เอาต์พุตเท่านั้น รายละเอียดเพิ่มเติมเกี่ยวกับการกำหนดค่า เซิร์ฟเวอร์ควรส่งคืนค่านี้เมื่อส่งคืนการกำหนดค่า
allowEncryptedScheduledInstall

boolean

ไม่บังคับ อนุญาตให้มีการตั้งเวลาติดตั้งแพ็กเกจในอุปกรณ์ที่เข้ารหัสได้หรือไม่
reminderDialogSettings

object (ReminderDialogSettings)

ไม่บังคับ การตั้งค่าสำหรับกล่องโต้ตอบโมดัลที่แจ้งเตือนผู้ใช้ว่ามีการอัปเดตที่รอดำเนินการ

UpdateDescription

คำอธิบายการอัปเดตที่ส่งไปยังอุปกรณ์

การแสดง JSON 
{
  "description": string,
  "title": string,
  "dialogMessage": string,
  "postSuccessMessage": string,
  "postFailureMessage": string
}
ช่อง
description

string

ข้อความคำอธิบายการอัปเดต
title

string

ชื่อคำอธิบายการอัปเดต
dialogMessage

string

ข้อความโต้ตอบของการอัปเดต
postSuccessMessage

string

ข้อความที่โพสต์สำเร็จของการอัปเดต ต้องใช้ API ระดับ 14 ขึ้นไป
postFailureMessage

string

ข้อความแจ้งโพสต์ไม่สำเร็จของการอัปเดต ต้องใช้ API ระดับ 14 ขึ้นไป

LocalizedUpdateDescription

คำอธิบายการอัปเดตตามภาษา

การแสดง JSON 
{
  "locales": [
    string
  ],
  "updateDescription": {
    object (UpdateDescription)
  }
}
ช่อง
locales[]

string

ภาษาที่ตรงกับภาษาของอุปกรณ์
updateDescription

object (UpdateDescription)

คำอธิบายการอัปเดตที่ส่งไปยังอุปกรณ์

UrgencyMode

โหมดเร่งการอัปเกรด

Enum
MODE_UNSPECIFIED ไม่ได้ระบุ
RECOMMENDED แนะนำให้อัปเกรด ระบบจะแจ้งให้ผู้ใช้ดาวน์โหลดและติดตั้งการอัปเดต
MANDATORY การอัปเกรดที่จำเป็น การอัปเดตจะดาวน์โหลดโดยอัตโนมัติแต่ผู้ใช้จะได้รับแจ้งให้เริ่มการติดตั้ง
AUTOMATIC การอัปเกรดอัตโนมัติ การอัปเดตจะถูกดาวน์โหลดและติดตั้งการอัปเดตโดยอัตโนมัติ

ScheduledInstallDelay

กรอบเวลาของความล่าช้าตั้งแต่เวลาที่อัปเดตได้จนถึงเวลาที่กําหนดเวลาการติดตั้งโดยอัตโนมัติ

Enum
SCHEDULED_INSTALL_DELAY_UNSPECIFIED ค่าเริ่มต้น จะถือว่าเป็น "ไม่เลย"
SCHEDULED_INSTALL_DELAY_NEVER ไม่ต้องส่งต่อไปยังการติดตั้งอัตโนมัติ
SCHEDULED_INSTALL_DELAY_ZERO_DAYS กรอบเวลาศูนย์วัน (ทันที)
SCHEDULED_INSTALL_DELAY_ONE_DAY กรอบเวลา 1 วัน
SCHEDULED_INSTALL_DELAY_TWO_DAYS กรอบเวลา 2 วัน
SCHEDULED_INSTALL_DELAY_THREE_DAYS กรอบเวลา 3 วัน
SCHEDULED_INSTALL_DELAY_FOUR_DAYS กรอบเวลา 4 วัน
SCHEDULED_INSTALL_DELAY_FIVE_DAYS กรอบเวลา 5 วัน
SCHEDULED_INSTALL_DELAY_TEN_DAYS กรอบเวลา 10 วัน
SCHEDULED_INSTALL_DELAY_FIFTEEN_DAYS กรอบเวลา 15 วัน
SCHEDULED_INSTALL_DELAY_THIRTY_DAYS กรอบเวลาสามสิบวัน

WifiOnlyTime

การดาวน์โหลดจะหลีกเลี่ยงเครือข่ายมือถือในช่วงนี้หลังจากพร้อมให้อัปเดต

Enum
WIFI_ONLY_TIME_UNSPECIFIED ไม่ได้ระบุ
NONE ไม่ถูกบล็อก
TWENTY_FOUR_HOURS กรอบเวลา 24 ชั่วโมง
THREE_DAYS กรอบเวลา 3 วัน
SEVEN_DAYS กรอบเวลา 7 วัน
FOURTEEN_DAYS กรอบเวลา 14 วัน
TWENTY_ONE_DAYS กรอบเวลา 21 วัน
FOREVER กรอบเวลานี้ตลอดไป

TimeWindow

กรอบเวลาที่กำหนดเวลาเริ่มต้นของวันและเวลาหยุดของวัน

การแสดง JSON 
{
  "startTime": {
    object (TimeOfDay)
  },
  "stopTime": {
    object (TimeOfDay)
  }
}
ช่อง
startTime

object (TimeOfDay)

เวลาเริ่มต้นของกรอบเวลา
stopTime

object (TimeOfDay)

เวลาสิ้นสุดของกรอบเวลา

TimeOfDay

แสดงเวลาของวัน วันที่และเขตเวลาไม่มีนัยสำคัญหรือระบุไว้ในที่อื่น API อาจเลือกอนุญาตวินาทีอธิกสุรทิน ประเภทที่เกี่ยวข้องคือ google.type.Date และ google.protobuf.Timestamp

การแสดง JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
ช่อง
hours

integer

ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ระหว่าง 0 ถึง 23 API อาจเลือกระบุค่า "24:00:00" ไว้สําหรับสถานการณ์ต่างๆ เช่น เวลาปิดทําการของธุรกิจ
minutes

integer

นาทีในชั่วโมงของวัน ต้องอยู่ระหว่าง 0 ถึง 59
seconds

integer

จำนวนวินาทีของนาที ปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตค่า 60 หากอนุญาตวินาทีอธิกสุรทิน
nanos

integer

เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องอยู่ระหว่าง 0 ถึง 999,999,999

OffPeakUpdate

ข้อจำกัดการอัปเดตที่เกิดขึ้นนอกช่วงสูงสุด

การแสดง JSON 
{
  "updateOffPeakWindow": {
    object (TimeWindow)
  },
  "updateOffPeakDays": enum (UpdateOffPeakDays),
  "updateOperatorRestriction": enum (CellularOperatorRestriction)
}
ช่อง
updateOffPeakWindow

object (TimeWindow)

ช่วงโลว์ซีซันในการดาวน์โหลดการอัปเดต ต้องใช้บริการ Google Play 6.7.72 ขึ้นไป
updateOffPeakDays

enum (UpdateOffPeakDays)

ไม่บังคับ เมื่อค่าเป็น OFF_PEAK_DAYS_UNSPECIFIED เซิร์ฟเวอร์จะใช้ค่าเริ่มต้น OFF_PEAK_UPDATE_ONE_DAY ต้องใช้บริการ Google Play 6.5 ขึ้นไป
updateOperatorRestriction

enum (CellularOperatorRestriction)

ไม่บังคับ หากไม่ได้ระบุค่า เซิร์ฟเวอร์จะใช้ค่าเริ่มต้น ALL_NETWORK_ALLOWED ต้องใช้บริการ Google Play 6.7.72 ขึ้นไป

UpdateOffPeakDays

จำนวนวันที่พยายามดาวน์โหลดอัปเดตในช่วงเวลาที่มีการใช้งานต่ำ

Enum
OFF_PEAK_DAYS_UNSPECIFIED ไม่ได้ระบุ
OFF_PEAK_UPDATE_ONE_DAY 1 วัน
OFF_PEAK_UPDATE_THREE_DAYS 3 วัน
OFF_PEAK_UPDATE_SEVEN_DAYS 7 วัน
OFF_PEAK_UPDATE_FOURTEEN_DAYS 14 วัน
OFF_PEAK_UPDATE_THIRTY_DAYS 30 วัน

CellularOperatorRestriction

ตั้งค่าเป็น CELLULAR_OPERATOR_RESTRICTED เพื่อกำหนดข้อจำกัดสำหรับช่วงที่มีการใช้งานต่ำ เพื่อจำกัดการดาวน์โหลด OTA ไว้สำหรับผู้ให้บริการเครือข่ายมือถือที่ได้รับเป็นครั้งแรก มีไว้สำหรับอุปกรณ์แบบหลายซิมเมื่อใช้ร่วมกับ mobileNetworkRestriction เพื่อจำกัดการดาวน์โหลดในช่วงที่มีการรับส่งข้อมูลสูงให้กับผู้ให้บริการบางราย

Enum
OPERATOR_RESTRICTED_UNSPECIFIED ไม่ได้ระบุ
CELLULAR_OPERATOR_RESTRICTED ช่วงโลว์ซีซันสำหรับผู้ให้บริการเครือข่ายมือถือที่ได้รับ OTA เป็นครั้งแรกเท่านั้น
ALL_NETWORK_ALLOWED ช่วงที่มีการรับส่งข้อมูลสูงใช้ได้กับทุกเครือข่าย

IncludeExclude

รวมหรือยกเว้นรูปแบบที่คั่นด้วยเครื่องหมายจุลภาคบางรูปแบบ

การแสดง JSON 
{

  // Union field include_exclude can be only one of the following:
  "include": string,
  "exclude": string
  // End of list of possible types for union field include_exclude.
}
ช่อง
ฟิลด์การรวม include_exclude กฎการรวมหรือการยกเว้น include_exclude ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
include

string

รูปแบบที่รวม หากอนุญาตให้มีได้หลายค่า ให้ใช้คอมมาเพื่อคั่นค่าแต่ละค่า
exclude

string

รูปแบบที่ยกเว้น หากอนุญาตให้มีได้หลายค่า ให้ใช้คอมมาเพื่อคั่นค่าแต่ละค่า

SpaceNeed

ข้อกำหนดด้านพื้นที่ในหน่วยไบต์

Enum
SPACE_NEED_UNSPECIFIED ไม่ได้ระบุ
ONE_HUNDRED_MB 100 MB
ONE_HUNDRED_AND_FIFTY_MB 150 MB
TWO_HUNDRED_AND_FIFTY_MB 250 MB
FIVE_HUNDRED_MB 500 MB

RolloutStep

คอมโพเนนต์ขั้นตอนการเปิดตัว

การแสดง JSON 
{
  "rolloutTime": string,
  "fraction": number
}
ช่อง
rolloutTime

string (Timestamp format)

การประทับเวลาเปิดตัว

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
fraction

number

เศษส่วนที่ระบุเป็นเปอร์เซ็นต์ระหว่าง 0.00 ถึง 100.00

ConfigDetails

รายละเอียดของการกำหนดค่า

การแสดง JSON 
{
  "postConditions": [
    {
      object (Condition)
    }
  ],
  "packages": [
    {
      object (PackageConfig)
    }
  ],
  "groups": [
    string
  ],
  "versionTag": {
    object (VersionTag)
  }
}
ช่อง
postConditions[]

object (Condition)

เงื่อนไขหลังการติดตั้งการกำหนดค่า
packages[]

object (PackageConfig)

แพ็กเกจที่กําหนดไว้ของการกําหนดค่านี้ สำคัญ: ลำดับของพัสดุเป็นสิ่งสำคัญ หากอุปกรณ์ตรงกับเงื่อนไขเบื้องต้นหลายชุด แพ็กเกจที่ตรงกันครั้งล่าสุดจะชนะและนำไปใช้กับอุปกรณ์
groups[]

string

กลุ่มที่เชื่อมโยงของการกำหนดค่านี้
versionTag

object (VersionTag)

เอาต์พุตเท่านั้น เวอร์ชันการกำหนดค่า

ReminderDialogSettings

การตั้งค่าการควบคุมกล่องโต้ตอบการช่วยเตือนแบบโมดัลที่แสดงแก่ผู้ใช้หลังจากระยะเวลาที่ระบุ

การแสดง JSON 
{
  "start": enum (Start),
  "remindMeLaterDuration": enum (RemindLaterDuration),
  "frequency": enum (Frequency)
}
ช่อง
start

enum (Start)

เวลาที่จะเริ่มแสดงการช่วยเตือน
remindMeLaterDuration

enum (RemindLaterDuration)

ระยะเวลา "เตือนฉันในภายหลัง" แสดงอยู่
frequency

enum (Frequency)

การแจ้งเตือนความถี่จะแสดงหลังจากการปิด

เริ่ม

กรณีที่ควรแสดงกล่องโต้ตอบการช่วยเตือน เช่น หากตั้งค่าเป็น START_TWO_DAYS ผู้ใช้จะเห็นการช่วยเตือนหลังจากได้รับการอัปเดต 2 วัน หากเหลือ START_UNSPECIFIED ระบบจะใช้ค่าเริ่มต้น START_SEVEN_DAYS

Enum
START_UNSPECIFIED ไม่ได้ระบุ
NEVER_START ไม่ต้องเริ่มการช่วยเตือน
START_ZERO_DAYS เริ่มทันที
START_TWO_DAYS เริ่มหลังจาก 2 วัน
START_SEVEN_DAYS เริ่มหลังจาก 7 วัน
START_FOURTEEN_DAYS เริ่มหลังจาก 14 วัน แท็กถัดไป: 6

RemindLaterDuration

ระยะเวลาที่กล่องโต้ตอบจะแสดงปุ่ม "เตือนฉันในภายหลัง" เลือก ALWAYS_SHOW เพื่อแสดงปุ่มตลอดเวลา และ NEVER_SHOW หากไม่ต้องการแสดงปุ่มนี้ หากเหลือ LATER_DURATION_UNSPECIFIED ระบบจะใช้ค่าเริ่มต้น LATER_FOURTEEN_DAYS

Enum
LATER_DURATION_UNSPECIFIED ไม่ได้ระบุ
NEVER_SHOW ไม่ต้องแสดงปุ่ม
ALWAYS_SHOW แสดงปุ่มเสมอ
LATER_SEVEN_DAYS นำปุ่มออกหลังจากผ่านไป 7 วัน
LATER_FOURTEEN_DAYS นำปุ่มออกหลังจากผ่านไป 14 วัน
LATER_TWENTY_ONE_DAYS นำปุ่มออกหลังจากผ่านไป 21 วัน

ความถี่

หลังจากผู้ใช้ปิดกล่องโต้ตอบการช่วยเตือน จะต้องรอนานเท่าใดกว่ากล่องโต้ตอบจะแสดงอีกครั้ง หากเหลือ FREQUENCY_UNSPECIFIED ระบบจะใช้ค่าเริ่มต้น FREQUENCY_SEVEN_DAYS

Enum
FREQUENCY_UNSPECIFIED ไม่ได้ระบุ
FREQUENCY_ONE_DAY แสดงการช่วยเตือนทุกวัน
FREQUENCY_THREE_DAYS แสดงการช่วยเตือนทุก 3 วัน
FREQUENCY_SEVEN_DAYS แสดงการช่วยเตือนทุก 7 วัน

วิธีการ

create

 สร้าง config และแสดงผล Config ใหม่

delete

 ลบ config

disable

 ปิดใช้กลุ่มที่เปิดใช้ทั้งหมดที่มีการกำหนดค่าที่ระบุ

get

 ได้รับยอดดู config

list

 แสดงรายการ configs ของการทำให้ใช้งานได้

update

 อัปเดต config

updatePackages

 โปรดอัปเดตแพ็กเกจในส่วนการกำหนดค่า