Method: projects.searchApps

Liệt kê tất cả Ứng dụng có sẵn cho FirebaseProject được chỉ định.

Đây là một phương pháp tiện lợi. Thông thường, việc tương tác với Ứng dụng phải được thực hiện bằng cách sử dụng dịch vụ dành riêng cho nền tảng, nhưng một số trường hợp sử dụng công cụ yêu cầu bản tóm tắt tất cả các Ứng dụng đã biết (chẳng hạn như đối với giao diện bộ chọn Ứng dụng).

Yêu cầu HTTP

GET https://firebase.googleapis.com/v1beta1/{parent=projects/*}:searchApps

URL sử dụng cú pháp Chuyển mã gRPC .

Tham số đường dẫn

Thông số
parent

string

Dự FirebaseProject gốc để liệt kê Ứng dụng, theo định dạng:

projects/ PROJECT_IDENTIFIER

Tham khảo trường name FirebaseProject để biết chi tiết về các giá trị PROJECT_IDENTIFIER .

Tham số truy vấn

Thông số
pageToken

string

Mã thông báo được trả về từ lệnh gọi trước tới projects.searchApps cho biết vị trí trong nhóm Ứng dụng sẽ tiếp tục danh sách.

pageSize

integer

Số lượng ứng dụng tối đa được trả về trong phản hồi.

Máy chủ có thể trả về ít hơn giá trị này theo quyết định riêng của mình. Nếu không có giá trị nào được chỉ định (hoặc giá trị quá lớn được chỉ định), thì máy chủ sẽ áp đặt giới hạn của chính nó.

Giá trị này không thể âm.

filter

string

Chuỗi truy vấn tương thích với tiêu chuẩn AIP-160 của Google .

Sử dụng bất kỳ trường nào sau đây trong truy vấn:

Truy vấn này cũng hỗ trợ các trường "ảo" sau. Đây là các trường không thực sự là một phần của đối tượng tài nguyên được trả về nhưng chúng có thể được truy vấn như thể chúng được điền sẵn các giá trị cụ thể.

  • sha1_hash hoặc sha1Hashes : Trường này được coi là trường string lặp lại , chứa danh sách tất cả dấu vân tay chứng chỉ SHA-1 đã đăng ký với AndroidApp . Danh sách này trống nếu Ứng dụng không phải là AndroidApp .
  • sha256_hash hoặc sha256Hashes : Trường này được coi là trường string lặp lại , chứa danh sách tất cả dấu vân tay chứng chỉ SHA-256 đã đăng ký với AndroidApp . Danh sách này trống nếu Ứng dụng không phải là AndroidApp .
  • appStoreId : Trường này được coi là trường string đơn , được điền ID Apple App Store đã đăng ký với IosApp . Trường này trống nếu Ứng dụng không phải là IosApp .
  • teamId : Trường này được coi là trường string đơn , được điền ID nhóm Apple đã đăng ký với IosApp . Trường này trống nếu Ứng dụng không phải là IosApp .
showDeleted

boolean

Kiểm soát xem có nên trả lại Ứng dụng ở trạng thái DELETED hay không.

Nếu không được chỉ định, chỉ các Ứng dụng ACTIVE mới được trả về.

Nội dung yêu cầu

Phần thân yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn JSON
{
  "apps": [
    {
      object (FirebaseAppInfo)
    }
  ],
  "nextPageToken": string
}
Lĩnh vực
apps[]

object ( FirebaseAppInfo )

Một trang kết quả từ lệnh gọi tới projects.searchApps .

nextPageToken

string

Nếu danh sách kết quả quá lớn để có thể chứa một phản hồi duy nhất thì mã thông báo sẽ được trả về.

Mã thông báo này có thể được sử dụng trong các lệnh gọi tiếp theo tới projects.searchApps để tìm nhóm Ứng dụng tiếp theo.

Mã thông báo trang chỉ tồn tại trong thời gian ngắn và không nên tồn tại lâu dài.

Phạm vi ủy quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only
  • https://www.googleapis.com/auth/firebase
  • https://www.googleapis.com/auth/firebase.readonly

Để biết thêm thông tin, hãy xem Tổng quan về xác thực .

Thông tin ứng dụng Firebase

Bản tóm tắt cấp cao của một Ứng dụng.

Biểu diễn JSON
{
  "name": string,
  "displayName": string,
  "platform": enum (AppPlatform),
  "appId": string,
  "namespace": string,
  "apiKeyId": string,
  "state": enum (State)
}
Lĩnh vực
name

string

Tên tài nguyên của Ứng dụng Firebase, ở định dạng:

projects/ PROJECT_ID /iosApps/ APP_ID

hoặc

projects/ PROJECT_ID /androidApps/ APP_ID

hoặc

projects/ PROJECT_ID /webApps/ APP_ID

displayName

string

Tên hiển thị do người dùng chỉ định của Ứng dụng Firebase.

platform

enum ( AppPlatform )

Nền tảng của Ứng dụng Firebase.

appId

string

Chỉ đầu ra. Bất biến. Giá trị nhận dạng duy nhất trên toàn cầu do Firebase chỉ định cho WebApp .

Mã định danh này phải được coi là mã thông báo không rõ ràng vì định dạng dữ liệu không được chỉ định.

namespace

string

Chỉ đầu ra. Bất biến. Mã định danh dành riêng cho nền tảng của Ứng dụng.

Lưu ý: Đối với hầu hết các trường hợp sử dụng, hãy sử dụng appId , là mã định danh chuẩn, duy nhất trên toàn cầu để tham chiếu Ứng dụng.

Chuỗi này được lấy từ mã định danh riêng cho từng nền tảng: packageName cho AndroidApp , bundleId cho IosApp và webId cho WebApp . Nội dung của nó phải được coi là không rõ ràng vì định dạng mã nhận dạng gốc có thể thay đổi khi nền tảng phát triển. Chuỗi này chỉ là duy nhất trong FirebaseProject và các Ứng dụng được liên kết của nó.

apiKeyId

string

Giá trị nhận dạng (UID) duy nhất trên toàn cầu do Google chỉ định cho khóa API Firebase được liên kết với Ứng dụng.

Xin lưu ý rằng giá trị này là UID của khóa API chứ không phải keyString của khóa API. keyString là giá trị có thể tìm thấy trong cấu phần cấu hình của Ứng dụng ( AndroidApp | IosApp | WebApp ).

Nếu apiKeyId không được đặt trong các yêu cầu tạo Ứng dụng ( AndroidApp | IosApp | WebApp ), thì Firebase sẽ tự động liên kết apiKeyId với Ứng dụng. Khóa được liên kết tự động này có thể là khóa hợp lệ hiện có hoặc nếu không có khóa hợp lệ thì một khóa mới sẽ được cung cấp.

state

enum ( State )

Chỉ đầu ra. Trạng thái vòng đời của Ứng dụng.

Nền tảng ứng dụng

Các nền tảng có thể liên kết với Ứng dụng Firebase.

Enum
PLATFORM_UNSPECIFIED Trạng thái không xác định. Điều này chỉ được sử dụng để phân biệt các giá trị chưa được đặt.
IOS Ứng dụng Firebase được liên kết với iOS.
ANDROID Ứng dụng Firebase được liên kết với Android.
WEB Ứng dụng Firebase được liên kết với web.