Trang này được dịch bởi Cloud Translation API.

LeaderboardConfigurations

Trình bày cấu hình của bảng xếp hạng.

Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.

Biểu diễn tài nguyên

Đây là mẫu JSON cho tài nguyên cấu hình bảng xếp hạng.

{
  "kind": "gamesConfiguration#leaderboardConfiguration",
  "token": string,
  "id": string,
  "scoreOrder": string,
  "scoreMin": long,
  "scoreMax": long,
  "draft": {
    "kind": "gamesConfiguration#leaderboardConfigurationDetail",
    "name": {
      "kind": "gamesConfiguration#localizedStringBundle",
      "translations": [
        {
          "kind": "gamesConfiguration#localizedString",
          "locale": string,
          "value": string
        }
      ]
    },
    "iconUrl": string,
    "sortRank": integer,
    "scoreFormat": {
      "numberFormatType": string,
      "suffix": {
        "zero": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "one": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "two": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "few": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "many": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "other": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        }
      },
      "numDecimalPlaces": integer,
      "currencyCode": string
    }
  },
  "published": {
    "kind": "gamesConfiguration#leaderboardConfigurationDetail",
    "name": {
      "kind": "gamesConfiguration#localizedStringBundle",
      "translations": [
        {
          "kind": "gamesConfiguration#localizedString",
          "locale": string,
          "value": string
        }
      ]
    },
    "iconUrl": string,
    "sortRank": integer,
    "scoreFormat": {
      "numberFormatType": string,
      "suffix": {
        "zero": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "one": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "two": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "few": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "many": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        },
        "other": {
          "kind": "gamesConfiguration#localizedStringBundle",
          "translations": [
            {
              "kind": "gamesConfiguration#localizedString",
              "locale": string,
              "value": string
            }
          ]
        }
      },
      "numDecimalPlaces": integer,
      "currencyCode": string
    }
  }
}

Tên tài sản	Giá trị	Mô tả
`kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#leaderboardConfiguration` cố định.
`token`	`string`	Mã thông báo cho tài nguyên này.
`id`	`string`	Mã của bảng xếp hạng.
`scoreOrder`	`string`	Loại bảng xếp hạng. Các giá trị có thể là: "`LARGER_IS_BETTER`" – Điểm số đã đăng lớn hơn sẽ được xếp hạng cao hơn. "`SMALLER_IS_BETTER`" - Điểm đăng nhỏ hơn sẽ được xếp hạng cao hơn.
`scoreMin`	`long`	Điểm tối thiểu có thể được đăng lên bảng xếp hạng này.
`scoreMax`	`long`	Điểm tối đa có thể được đăng lên bảng xếp hạng này.
`draft`	`nested object`	Dữ liệu nháp của bảng xếp hạng.
`draft.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#leaderboardConfigurationDetail` cố định.
`draft.name`	`nested object`	Chuỗi đã bản địa hoá cho tên bảng xếp hạng.
`draft.name.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`draft.name.translations[]`	`list`	Chuỗi ngôn ngữ.
`draft.name.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`draft.name.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`draft.name.translations[].value`	`string`	Giá trị chuỗi.
`draft.iconUrl`	`string`	URL biểu tượng của bảng xếp hạng này. Các lượt ghi vào trường này sẽ bị bỏ qua.
`draft.sortRank`	`integer`	Thứ hạng của bảng xếp hạng này. Các lượt ghi vào trường này sẽ bị bỏ qua.
`draft.scoreFormat`	`nested object`	Định dạng điểm số của bảng xếp hạng.
`draft.scoreFormat.numberFormatType`	`string`	Định dạng số. Các giá trị có thể có là: "`NUMERIC`" – Số được định dạng để không chứa chữ số hoặc là một số cố định gồm các chữ số sau dấu thập phân theo ngôn ngữ. Bạn có thể thêm một đơn vị tuỳ chỉnh không bắt buộc. "`TIME_DURATION`" – Số được định dạng thành giờ, phút và giây. "`CURRENCY`" – Số được định dạng theo đơn vị tiền tệ theo địa phương.
`draft.scoreFormat.suffix`	`nested object`	Hậu tố tùy chọn cho loại định dạng {6/} Các chuỗi này tuân theo cùng một quy tắc số nhiều làm tất cả tài nguyên chuỗi Android.
`draft.scoreFormat.suffix.zero`	`nested object`	Khi ngôn ngữ yêu cầu cách xử lý đặc biệt đối với số 0 (như trong tiếng Ả Rập).
`draft.scoreFormat.suffix.zero.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`draft.scoreFormat.suffix.zero.translations[]`	`list`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.zero.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`draft.scoreFormat.suffix.zero.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.zero.translations[].value`	`string`	Giá trị chuỗi.
`draft.scoreFormat.suffix.one`	`nested object`	Khi ngôn ngữ yêu cầu xử lý đặc biệt các số chẳng hạn như số một (như với số 1 trong tiếng Anh và hầu hết ngôn ngữ khác; trong tiếng Nga, bất kỳ số nào kết thúc bằng số 1 nhưng không kết thúc bằng số 11 đều ở trong lớp này).
`draft.scoreFormat.suffix.one.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`draft.scoreFormat.suffix.one.translations[]`	`list`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.one.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`draft.scoreFormat.suffix.one.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.one.translations[].value`	`string`	Giá trị chuỗi.
`draft.scoreFormat.suffix.two`	`nested object`	Khi ngôn ngữ yêu cầu xử lý đặc biệt các số chẳng hạn như số hai (như với số 2 trong tiếng Wales hoặc 102 trong tiếng Slovenia).
`draft.scoreFormat.suffix.two.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`draft.scoreFormat.suffix.two.translations[]`	`list`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.two.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`draft.scoreFormat.suffix.two.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.two.translations[].value`	`string`	Giá trị chuỗi.
`draft.scoreFormat.suffix.few`	`nested object`	Khi ngôn ngữ yêu cầu cách xử lý đặc biệt các số "nhỏ" (như với số 2, 3 và 4 trong tiếng Séc; hoặc các số kết thúc bằng số 2, 3 hoặc 4 nhưng không phải là số 12, 13 hoặc 14 trong tiếng Ba Lan).
`draft.scoreFormat.suffix.few.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`draft.scoreFormat.suffix.few.translations[]`	`list`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.few.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`draft.scoreFormat.suffix.few.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.few.translations[].value`	`string`	Giá trị chuỗi.
`draft.scoreFormat.suffix.many`	`nested object`	Khi ngôn ngữ yêu cầu xử lý đặc biệt các số "lớn" (như các số kết thúc từ 11-99 trong tiếng Malta).
`draft.scoreFormat.suffix.many.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`draft.scoreFormat.suffix.many.translations[]`	`list`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.many.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`draft.scoreFormat.suffix.many.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.many.translations[].value`	`string`	Giá trị chuỗi.
`draft.scoreFormat.suffix.other`	`nested object`	Khi ngôn ngữ không yêu cầu xử lý đặc biệt về số lượng đã cho (như với tất cả các số trong tiếng Trung, hoặc số 42 trong tiếng Anh).
`draft.scoreFormat.suffix.other.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`draft.scoreFormat.suffix.other.translations[]`	`list`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.other.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`draft.scoreFormat.suffix.other.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`draft.scoreFormat.suffix.other.translations[].value`	`string`	Giá trị chuỗi.
`draft.scoreFormat.numDecimalPlaces`	`integer`	Số vị trí thập phân của số. Chỉ được dùng cho loại định dạng GPay.
`draft.scoreFormat.currencyCode`	`string`	Chuỗi mã hiện tại. Chỉ được sử dụng cho loại định dạng CURRENCY.
`published`	`nested object`	Dữ liệu đã công bố của bảng xếp hạng. Dữ liệu này chỉ có thể đọc.
`published.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#leaderboardConfigurationDetail` cố định.
`published.name`	`nested object`	Chuỗi đã bản địa hoá cho tên bảng xếp hạng.
`published.name.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`published.name.translations[]`	`list`	Chuỗi ngôn ngữ.
`published.name.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`published.name.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`published.name.translations[].value`	`string`	Giá trị chuỗi.
`published.iconUrl`	`string`	URL biểu tượng của bảng xếp hạng này. Các lượt ghi vào trường này sẽ bị bỏ qua.
`published.sortRank`	`integer`	Thứ hạng của bảng xếp hạng này. Các lượt ghi vào trường này sẽ bị bỏ qua.
`published.scoreFormat`	`nested object`	Định dạng điểm số của bảng xếp hạng.
`published.scoreFormat.numberFormatType`	`string`	Định dạng số. Các giá trị có thể có là: "`NUMERIC`" – Số được định dạng để không chứa chữ số hoặc là một số cố định gồm các chữ số sau dấu thập phân theo ngôn ngữ. Bạn có thể thêm một đơn vị tuỳ chỉnh không bắt buộc. "`TIME_DURATION`" – Số được định dạng thành giờ, phút và giây. "`CURRENCY`" – Số được định dạng theo đơn vị tiền tệ theo địa phương.
`published.scoreFormat.suffix`	`nested object`	Hậu tố tùy chọn cho loại định dạng {6/} Các chuỗi này tuân theo cùng một quy tắc số nhiều làm tất cả tài nguyên chuỗi Android.
`published.scoreFormat.suffix.zero`	`nested object`	Khi ngôn ngữ yêu cầu cách xử lý đặc biệt đối với số 0 (như trong tiếng Ả Rập).
`published.scoreFormat.suffix.zero.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`published.scoreFormat.suffix.zero.translations[]`	`list`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.zero.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`published.scoreFormat.suffix.zero.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.zero.translations[].value`	`string`	Giá trị chuỗi.
`published.scoreFormat.suffix.one`	`nested object`	Khi ngôn ngữ yêu cầu xử lý đặc biệt các số chẳng hạn như số một (như với số 1 trong tiếng Anh và hầu hết ngôn ngữ khác; trong tiếng Nga, bất kỳ số nào kết thúc bằng số 1 nhưng không kết thúc bằng số 11 đều ở trong lớp này).
`published.scoreFormat.suffix.one.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`published.scoreFormat.suffix.one.translations[]`	`list`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.one.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`published.scoreFormat.suffix.one.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.one.translations[].value`	`string`	Giá trị chuỗi.
`published.scoreFormat.suffix.two`	`nested object`	Khi ngôn ngữ yêu cầu xử lý đặc biệt các số chẳng hạn như số hai (như với số 2 trong tiếng Wales hoặc 102 trong tiếng Slovenia).
`published.scoreFormat.suffix.two.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`published.scoreFormat.suffix.two.translations[]`	`list`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.two.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`published.scoreFormat.suffix.two.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.two.translations[].value`	`string`	Giá trị chuỗi.
`published.scoreFormat.suffix.few`	`nested object`	Khi ngôn ngữ yêu cầu cách xử lý đặc biệt các số "nhỏ" (như với số 2, 3 và 4 trong tiếng Séc; hoặc các số kết thúc bằng số 2, 3 hoặc 4 nhưng không phải là số 12, 13 hoặc 14 trong tiếng Ba Lan).
`published.scoreFormat.suffix.few.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`published.scoreFormat.suffix.few.translations[]`	`list`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.few.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`published.scoreFormat.suffix.few.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.few.translations[].value`	`string`	Giá trị chuỗi.
`published.scoreFormat.suffix.many`	`nested object`	Khi ngôn ngữ yêu cầu xử lý đặc biệt các số "lớn" (như các số kết thúc từ 11-99 trong tiếng Malta).
`published.scoreFormat.suffix.many.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`published.scoreFormat.suffix.many.translations[]`	`list`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.many.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`published.scoreFormat.suffix.many.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.many.translations[].value`	`string`	Giá trị chuỗi.
`published.scoreFormat.suffix.other`	`nested object`	Khi ngôn ngữ không yêu cầu xử lý đặc biệt về số lượng đã cho (như với tất cả các số trong tiếng Trung, hoặc số 42 trong tiếng Anh).
`published.scoreFormat.suffix.other.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedStringBundle` cố định.
`published.scoreFormat.suffix.other.translations[]`	`list`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.other.translations[].kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi `gamesConfiguration#localizedString` cố định.
`published.scoreFormat.suffix.other.translations[].locale`	`string`	Chuỗi ngôn ngữ.
`published.scoreFormat.suffix.other.translations[].value`	`string`	Giá trị chuỗi.
`published.scoreFormat.numDecimalPlaces`	`integer`	Số vị trí thập phân của số. Chỉ được dùng cho loại định dạng GPay.
`published.scoreFormat.currencyCode`	`string`	Chuỗi mã hiện tại. Chỉ được sử dụng cho loại định dạng CURRENCY.

Phương thức

xóa: Xoá cấu hình bảng xếp hạng có mã nhận dạng đã cấp.
nhận: Truy xuất siêu dữ liệu của cấu hình bảng xếp hạng bằng mã nhận dạng đã cho.
chèn: Chèn một cấu hình bảng xếp hạng mới trong ứng dụng này.
list: Trả về danh sách các cấu hình bảng xếp hạng trong ứng dụng này.
cập nhật: Cập nhật siêu dữ liệu của cấu hình bảng xếp hạng bằng mã nhận dạng đã cấp.