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ả Ghi chú
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.