REST Resource: projects.webApps

Resource: WebApp

Details of a Firebase App for the web.

JSON representation
{
  "name": string,
  "appId": string,
  "displayName": string,
  "projectId": string,
  "appUrls": [
    string
  ],
  "webId": string,
  "apiKeyId": string,
  "state": enum (State),
  "etag": string
}
Fields
name

string

The resource name of the WebApp, in the format:

projects/PROJECT_IDENTIFIER/webApps/APP_ID

  • PROJECT_IDENTIFIER: the parent Project's ProjectNumber (recommended) or its ProjectId. Learn more about using project identifiers in Google's AIP 2510 standard.
    Note that the value for PROJECT_IDENTIFIER in any response body will be the ProjectId.
  • APP_ID: the globally unique, Firebase-assigned identifier for the App (see appId).
appId

string

Output only. Immutable. The globally unique, Firebase-assigned identifier for the WebApp.

This identifier should be treated as an opaque token, as the data format is not specified.

displayName

string

The user-assigned display name for the WebApp.

projectId

string

Output only. Immutable. A user-assigned unique identifier of the parent FirebaseProject for the WebApp.

appUrls[]

string

The URLs where the WebApp is hosted.

webId
(deprecated)

string

Output only. Immutable. A unique, Firebase-assigned identifier for the WebApp.

This identifier is only used to populate the namespace value for the WebApp. For most use cases, use appId to identify or reference the App. The webId value is only unique within a FirebaseProject and its associated Apps.

apiKeyId

string

The globally unique, Google-assigned identifier (UID) for the Firebase API key associated with the WebApp.

Be aware that this value is the UID of the API key, not the keyString of the API key. The keyString is the value that can be found in the App's configuration artifact.

If apiKeyId is not set in requests to webApps.Create, then Firebase automatically associates an apiKeyId with the WebApp. This auto-associated key may be an existing valid key or, if no valid key exists, a new one will be provisioned.

In patch requests, apiKeyId cannot be set to an empty value, and the new UID must have no restrictions or only have restrictions that are valid for the associated WebApp. We recommend using the Google Cloud Console to manage API keys.

state

enum (State)

Output only. The lifecycle state of the App.

etag

string

This checksum is computed by the server based on the value of other fields, and it may be sent with update requests to ensure the client has an up-to-date value before proceeding.

Learn more about etag in Google's AIP-154 standard.

This etag is strongly validated.

Methods

create

Requests the creation of a new WebApp in the specified FirebaseProject.

get

Gets the specified WebApp.

getConfig

Gets the configuration artifact associated with the specified WebApp.

list

Lists each WebApp associated with the specified FirebaseProject.

patch

Updates the attributes of the specified WebApp.

remove

Removes the specified WebApp from the FirebaseProject.

undelete

Restores the specified WebApp to the FirebaseProject.