718 lines
32 KiB
JSON
718 lines
32 KiB
JSON
|
{
|
||
|
|
"discoveryVersion": "v1",
|
||
|
|
"version_module": "True",
|
||
|
|
"schemas": {
|
||
|
|
"FunctionCall": {
|
||
|
|
"description": "Represents a service-defined function call that was invoked during test\nexecution.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"args": {
|
||
|
|
"description": "The arguments that were provided to the function.",
|
||
|
|
"type": "array",
|
||
|
|
"items": {
|
||
|
|
"type": "any"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"function": {
|
||
|
|
"description": "Name of the function invoked.",
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "FunctionCall"
|
||
|
|
},
|
||
|
|
"File": {
|
||
|
|
"description": "`File` containing source content.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"fingerprint": {
|
||
|
|
"description": "Fingerprint (e.g. github sha) associated with the `File`.",
|
||
|
|
"format": "byte",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"name": {
|
||
|
|
"description": "File name.",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"content": {
|
||
|
|
"description": "Textual Content.",
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "File"
|
||
|
|
},
|
||
|
|
"ListReleasesResponse": {
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"nextPageToken": {
|
||
|
|
"description": "The pagination token to retrieve the next page of results. If the value is\nempty, no further results remain.",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"releases": {
|
||
|
|
"type": "array",
|
||
|
|
"items": {
|
||
|
|
"$ref": "Release"
|
||
|
|
},
|
||
|
|
"description": "List of `Release` instances."
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "ListReleasesResponse",
|
||
|
|
"description": "The response for FirebaseRulesService.ListReleases."
|
||
|
|
},
|
||
|
|
"Release": {
|
||
|
|
"description": "`Release` is a named reference to a `Ruleset`. Once a `Release` refers to a\n`Ruleset`, rules-enabled services will be able to enforce the `Ruleset`.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"updateTime": {
|
||
|
|
"description": "Time the release was updated.\nOutput only.",
|
||
|
|
"format": "google-datetime",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"name": {
|
||
|
|
"description": "Resource name for the `Release`.\n\n`Release` names may be structured `app1/prod/v2` or flat `app1_prod_v2`\nwhich affords developers a great deal of flexibility in mapping the name\nto the style that best fits their existing development practices. For\nexample, a name could refer to an environment, an app, a version, or some\ncombination of three.\n\nIn the table below, for the project name `projects/foo`, the following\nrelative release paths show how flat and structured names might be chosen\nto match a desired development / deployment strategy.\n\nUse Case | Flat Name | Structured Name\n-------------|---------------------|----------------\nEnvironments | releases/qa | releases/qa\nApps | releases/app1_qa | releases/app1/qa\nVersions | releases/app1_v2_qa | releases/app1/v2/qa\n\nThe delimiter between the release name path elements can be almost anything\nand it should work equally well with the release name list filter, but in\nmany ways the structured paths provide a clearer picture of the\nrelationship between `Release` instances.\n\nFormat: `projects/{project_id}/releases/{release_id}`",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"rulesetName": {
|
||
|
|
"description": "Name of the `Ruleset` referred to by this `Release`. The `Ruleset` must\nexist the `Release` to be created.",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"createTime": {
|
||
|
|
"description": "Time the release was created.\nOutput only.",
|
||
|
|
"format": "google-datetime",
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "Release"
|
||
|
|
},
|
||
|
|
"TestRulesetResponse": {
|
||
|
|
"description": "The response for FirebaseRulesService.TestRuleset.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"testResults": {
|
||
|
|
"description": "The set of test results given the test cases in the `TestSuite`.\nThe results will appear in the same order as the test cases appear in the\n`TestSuite`.",
|
||
|
|
"type": "array",
|
||
|
|
"items": {
|
||
|
|
"$ref": "TestResult"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"issues": {
|
||
|
|
"description": "Syntactic and semantic `Source` issues of varying severity. Issues of\n`ERROR` severity will prevent tests from executing.",
|
||
|
|
"type": "array",
|
||
|
|
"items": {
|
||
|
|
"$ref": "Issue"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "TestRulesetResponse"
|
||
|
|
},
|
||
|
|
"ListRulesetsResponse": {
|
||
|
|
"id": "ListRulesetsResponse",
|
||
|
|
"description": "The response for FirebaseRulesService.ListRulesets.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"rulesets": {
|
||
|
|
"description": "List of `Ruleset` instances.",
|
||
|
|
"type": "array",
|
||
|
|
"items": {
|
||
|
|
"$ref": "Ruleset"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"nextPageToken": {
|
||
|
|
"description": "The pagination token to retrieve the next page of results. If the value is\nempty, no further results remain.",
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"TestResult": {
|
||
|
|
"properties": {
|
||
|
|
"functionCalls": {
|
||
|
|
"description": "The set of function calls made to service-defined methods.\n\nFunction calls are included in the order in which they are encountered\nduring evaluation, are provided for both mocked and unmocked functions,\nand included on the response regardless of the test `state`.",
|
||
|
|
"type": "array",
|
||
|
|
"items": {
|
||
|
|
"$ref": "FunctionCall"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"state": {
|
||
|
|
"enumDescriptions": [
|
||
|
|
"Test state is not set.",
|
||
|
|
"Test is a success.",
|
||
|
|
"Test is a failure."
|
||
|
|
],
|
||
|
|
"enum": [
|
||
|
|
"STATE_UNSPECIFIED",
|
||
|
|
"SUCCESS",
|
||
|
|
"FAILURE"
|
||
|
|
],
|
||
|
|
"description": "State of the test.",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"debugMessages": {
|
||
|
|
"description": "Debug messages related to test execution issues encountered during\nevaluation.\n\nDebug messages may be related to too many or too few invocations of\nfunction mocks or to runtime errors that occur during evaluation.\n\nFor example: ```Unable to read variable [name: \"resource\"]```",
|
||
|
|
"type": "array",
|
||
|
|
"items": {
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"errorPosition": {
|
||
|
|
"description": "Position in the `Source` or `Ruleset` where the principle runtime error\noccurs.\n\nEvaluation of an expression may result in an error. Rules are deny by\ndefault, so a `DENY` expectation when an error is generated is valid.\nWhen there is a `DENY` with an error, the `SourcePosition` is returned.\n\nE.g. `error_position { line: 19 column: 37 }`",
|
||
|
|
"$ref": "SourcePosition"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "TestResult",
|
||
|
|
"description": "Test result message containing the state of the test as well as a\ndescription and source position for test failures.",
|
||
|
|
"type": "object"
|
||
|
|
},
|
||
|
|
"Empty": {
|
||
|
|
"description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {},
|
||
|
|
"id": "Empty"
|
||
|
|
},
|
||
|
|
"Source": {
|
||
|
|
"description": "`Source` is one or more `File` messages comprising a logical set of rules.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"files": {
|
||
|
|
"description": "`File` set constituting the `Source` bundle.",
|
||
|
|
"type": "array",
|
||
|
|
"items": {
|
||
|
|
"$ref": "File"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "Source"
|
||
|
|
},
|
||
|
|
"SourcePosition": {
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"line": {
|
||
|
|
"description": "Line number of the source fragment. 1-based.",
|
||
|
|
"format": "int32",
|
||
|
|
"type": "integer"
|
||
|
|
},
|
||
|
|
"column": {
|
||
|
|
"description": "First column on the source line associated with the source fragment.",
|
||
|
|
"format": "int32",
|
||
|
|
"type": "integer"
|
||
|
|
},
|
||
|
|
"fileName": {
|
||
|
|
"description": "Name of the `File`.",
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "SourcePosition",
|
||
|
|
"description": "Position in the `Source` content including its line, column number, and an\nindex of the `File` in the `Source` message. Used for debug purposes."
|
||
|
|
},
|
||
|
|
"Ruleset": {
|
||
|
|
"description": "`Ruleset` is an immutable copy of `Source` with a globally unique identifier\nand a creation time.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"name": {
|
||
|
|
"description": "Name of the `Ruleset`. The ruleset_id is auto generated by the service.\nFormat: `projects/{project_id}/rulesets/{ruleset_id}`\nOutput only.",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"source": {
|
||
|
|
"$ref": "Source",
|
||
|
|
"description": "`Source` for the `Ruleset`."
|
||
|
|
},
|
||
|
|
"createTime": {
|
||
|
|
"description": "Time the `Ruleset` was created.\nOutput only.",
|
||
|
|
"format": "google-datetime",
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "Ruleset"
|
||
|
|
},
|
||
|
|
"Issue": {
|
||
|
|
"description": "Issues include warnings, errors, and deprecation notices.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"sourcePosition": {
|
||
|
|
"$ref": "SourcePosition",
|
||
|
|
"description": "Position of the issue in the `Source`."
|
||
|
|
},
|
||
|
|
"severity": {
|
||
|
|
"enum": [
|
||
|
|
"SEVERITY_UNSPECIFIED",
|
||
|
|
"DEPRECATION",
|
||
|
|
"WARNING",
|
||
|
|
"ERROR"
|
||
|
|
],
|
||
|
|
"description": "The severity of the issue.",
|
||
|
|
"type": "string",
|
||
|
|
"enumDescriptions": [
|
||
|
|
"An unspecified severity.",
|
||
|
|
"Deprecation issue for statements and method that may no longer be\nsupported or maintained.",
|
||
|
|
"Warnings such as: unused variables.",
|
||
|
|
"Errors such as: unmatched curly braces or variable redefinition."
|
||
|
|
]
|
||
|
|
},
|
||
|
|
"description": {
|
||
|
|
"description": "Short error description.",
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "Issue"
|
||
|
|
},
|
||
|
|
"TestRulesetRequest": {
|
||
|
|
"description": "The request for FirebaseRulesService.TestRuleset.",
|
||
|
|
"type": "object",
|
||
|
|
"properties": {
|
||
|
|
"source": {
|
||
|
|
"$ref": "Source",
|
||
|
|
"description": "Optional `Source` to be checked for correctness.\n\nThis field must not be set when the resource name refers to a `Ruleset`."
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"id": "TestRulesetRequest"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"icons": {
|
||
|
|
"x32": "http://www.google.com/images/icons/product/search-32.gif",
|
||
|
|
"x16": "http://www.google.com/images/icons/product/search-16.gif"
|
||
|
|
},
|
||
|
|
"protocol": "rest",
|
||
|
|
"canonicalName": "Firebase Rules",
|
||
|
|
"auth": {
|
||
|
|
"oauth2": {
|
||
|
|
"scopes": {
|
||
|
|
"https://www.googleapis.com/auth/firebase": {
|
||
|
|
"description": "View and administer all your Firebase data and settings"
|
||
|
|
},
|
||
|
|
"https://www.googleapis.com/auth/firebase.readonly": {
|
||
|
|
"description": "View all your Firebase data and settings"
|
||
|
|
},
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform": {
|
||
|
|
"description": "View and manage your data across Google Cloud Platform services"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"rootUrl": "https://firebaserules.googleapis.com/",
|
||
|
|
"ownerDomain": "google.com",
|
||
|
|
"name": "firebaserules",
|
||
|
|
"batchPath": "batch",
|
||
|
|
"title": "Firebase Rules API",
|
||
|
|
"ownerName": "Google",
|
||
|
|
"resources": {
|
||
|
|
"projects": {
|
||
|
|
"methods": {
|
||
|
|
"test": {
|
||
|
|
"id": "firebaserules.projects.test",
|
||
|
|
"path": "v1/{+name}:test",
|
||
|
|
"request": {
|
||
|
|
"$ref": "TestRulesetRequest"
|
||
|
|
},
|
||
|
|
"description": "Test `Source` for syntactic and semantic correctness. Issues present, if\nany, will be returned to the caller with a description, severity, and\nsource location.\n\nThe test method may be executed with `Source` or a `Ruleset` name.\nPassing `Source` is useful for unit testing new rules. Passing a `Ruleset`\nname is useful for regression testing an existing rule.\n\nThe following is an example of `Source` that permits users to upload images\nto a bucket bearing their user id and matching the correct metadata:\n\n_*Example*_\n\n // Users are allowed to subscribe and unsubscribe to the blog.\n service firebase.storage {\n match /users/{userId}/images/{imageName} {\n allow write: if userId == request.auth.uid\n && (imageName.matches('*.png$')\n || imageName.matches('*.jpg$'))\n && resource.mimeType.matches('^image/')\n }\n }",
|
||
|
|
"httpMethod": "POST",
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"response": {
|
||
|
|
"$ref": "TestRulesetResponse"
|
||
|
|
},
|
||
|
|
"parameters": {
|
||
|
|
"name": {
|
||
|
|
"description": "Tests may either provide `source` or a `Ruleset` resource name.\n\nFor tests against `source`, the resource name must refer to the project:\nFormat: `projects/{project_id}`\n\nFor tests against a `Ruleset`, this must be the `Ruleset` resource name:\nFormat: `projects/{project_id}/rulesets/{ruleset_id}`",
|
||
|
|
"required": true,
|
||
|
|
"type": "string",
|
||
|
|
"pattern": "^projects/.+$",
|
||
|
|
"location": "path"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase",
|
||
|
|
"https://www.googleapis.com/auth/firebase.readonly"
|
||
|
|
],
|
||
|
|
"flatPath": "v1/projects/{projectsId}:test"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"resources": {
|
||
|
|
"rulesets": {
|
||
|
|
"methods": {
|
||
|
|
"get": {
|
||
|
|
"description": "Get a `Ruleset` by name including the full `Source` contents.",
|
||
|
|
"response": {
|
||
|
|
"$ref": "Ruleset"
|
||
|
|
},
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"httpMethod": "GET",
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase",
|
||
|
|
"https://www.googleapis.com/auth/firebase.readonly"
|
||
|
|
],
|
||
|
|
"parameters": {
|
||
|
|
"name": {
|
||
|
|
"description": "Resource name for the ruleset to get.\n\nFormat: `projects/{project_id}/rulesets/{ruleset_id}`",
|
||
|
|
"required": true,
|
||
|
|
"type": "string",
|
||
|
|
"pattern": "^projects/[^/]+/rulesets/[^/]+$",
|
||
|
|
"location": "path"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"flatPath": "v1/projects/{projectsId}/rulesets/{rulesetsId}",
|
||
|
|
"path": "v1/{+name}",
|
||
|
|
"id": "firebaserules.projects.rulesets.get"
|
||
|
|
},
|
||
|
|
"list": {
|
||
|
|
"response": {
|
||
|
|
"$ref": "ListRulesetsResponse"
|
||
|
|
},
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"httpMethod": "GET",
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase",
|
||
|
|
"https://www.googleapis.com/auth/firebase.readonly"
|
||
|
|
],
|
||
|
|
"parameters": {
|
||
|
|
"filter": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "`Ruleset` filter. The list method supports filters with restrictions on\n`Ruleset.name`.\n\nFilters on `Ruleset.create_time` should use the `date` function which\nparses strings that conform to the RFC 3339 date/time specifications.\n\nExample: `create_time \u003e date(\"2017-01-01\") AND name=UUID-*`",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"name": {
|
||
|
|
"description": "Resource name for the project.\n\nFormat: `projects/{project_id}`",
|
||
|
|
"required": true,
|
||
|
|
"type": "string",
|
||
|
|
"pattern": "^projects/[^/]+$",
|
||
|
|
"location": "path"
|
||
|
|
},
|
||
|
|
"pageToken": {
|
||
|
|
"description": "Next page token for loading the next batch of `Ruleset` instances.",
|
||
|
|
"type": "string",
|
||
|
|
"location": "query"
|
||
|
|
},
|
||
|
|
"pageSize": {
|
||
|
|
"description": "Page size to load. Maximum of 100. Defaults to 10.\nNote: `page_size` is just a hint and the service may choose to load less\nthan `page_size` due to the size of the output. To traverse all of the\nreleases, caller should iterate until the `page_token` is empty.",
|
||
|
|
"format": "int32",
|
||
|
|
"type": "integer",
|
||
|
|
"location": "query"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"flatPath": "v1/projects/{projectsId}/rulesets",
|
||
|
|
"path": "v1/{+name}/rulesets",
|
||
|
|
"id": "firebaserules.projects.rulesets.list",
|
||
|
|
"description": "List `Ruleset` metadata only and optionally filter the results by `Ruleset`\nname.\n\nThe full `Source` contents of a `Ruleset` may be retrieved with\nGetRuleset."
|
||
|
|
},
|
||
|
|
"create": {
|
||
|
|
"httpMethod": "POST",
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"response": {
|
||
|
|
"$ref": "Ruleset"
|
||
|
|
},
|
||
|
|
"parameters": {
|
||
|
|
"name": {
|
||
|
|
"pattern": "^projects/[^/]+$",
|
||
|
|
"location": "path",
|
||
|
|
"description": "Resource name for Project which owns this `Ruleset`.\n\nFormat: `projects/{project_id}`",
|
||
|
|
"required": true,
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase"
|
||
|
|
],
|
||
|
|
"flatPath": "v1/projects/{projectsId}/rulesets",
|
||
|
|
"id": "firebaserules.projects.rulesets.create",
|
||
|
|
"path": "v1/{+name}/rulesets",
|
||
|
|
"request": {
|
||
|
|
"$ref": "Ruleset"
|
||
|
|
},
|
||
|
|
"description": "Create a `Ruleset` from `Source`.\n\nThe `Ruleset` is given a unique generated name which is returned to the\ncaller. `Source` containing syntactic or semantics errors will result in an\nerror response indicating the first error encountered. For a detailed view\nof `Source` issues, use TestRuleset."
|
||
|
|
},
|
||
|
|
"delete": {
|
||
|
|
"httpMethod": "DELETE",
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"response": {
|
||
|
|
"$ref": "Empty"
|
||
|
|
},
|
||
|
|
"parameters": {
|
||
|
|
"name": {
|
||
|
|
"pattern": "^projects/[^/]+/rulesets/[^/]+$",
|
||
|
|
"location": "path",
|
||
|
|
"description": "Resource name for the ruleset to delete.\n\nFormat: `projects/{project_id}/rulesets/{ruleset_id}`",
|
||
|
|
"required": true,
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase"
|
||
|
|
],
|
||
|
|
"flatPath": "v1/projects/{projectsId}/rulesets/{rulesetsId}",
|
||
|
|
"id": "firebaserules.projects.rulesets.delete",
|
||
|
|
"path": "v1/{+name}",
|
||
|
|
"description": "Delete a `Ruleset` by resource name.\n\nIf the `Ruleset` is referenced by a `Release` the operation will fail."
|
||
|
|
}
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"releases": {
|
||
|
|
"methods": {
|
||
|
|
"delete": {
|
||
|
|
"response": {
|
||
|
|
"$ref": "Empty"
|
||
|
|
},
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"httpMethod": "DELETE",
|
||
|
|
"parameters": {
|
||
|
|
"name": {
|
||
|
|
"description": "Resource name for the `Release` to delete.\n\nFormat: `projects/{project_id}/releases/{release_id}`",
|
||
|
|
"required": true,
|
||
|
|
"type": "string",
|
||
|
|
"pattern": "^projects/[^/]+/releases/.+$",
|
||
|
|
"location": "path"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase"
|
||
|
|
],
|
||
|
|
"flatPath": "v1/projects/{projectsId}/releases/{releasesId}",
|
||
|
|
"path": "v1/{+name}",
|
||
|
|
"id": "firebaserules.projects.releases.delete",
|
||
|
|
"description": "Delete a `Release` by resource name."
|
||
|
|
},
|
||
|
|
"get": {
|
||
|
|
"httpMethod": "GET",
|
||
|
|
"response": {
|
||
|
|
"$ref": "Release"
|
||
|
|
},
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"parameters": {
|
||
|
|
"name": {
|
||
|
|
"description": "Resource name of the `Release`.\n\nFormat: `projects/{project_id}/releases/{release_id}`",
|
||
|
|
"required": true,
|
||
|
|
"type": "string",
|
||
|
|
"pattern": "^projects/[^/]+/releases/.+$",
|
||
|
|
"location": "path"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase",
|
||
|
|
"https://www.googleapis.com/auth/firebase.readonly"
|
||
|
|
],
|
||
|
|
"flatPath": "v1/projects/{projectsId}/releases/{releasesId}",
|
||
|
|
"id": "firebaserules.projects.releases.get",
|
||
|
|
"path": "v1/{+name}",
|
||
|
|
"description": "Get a `Release` by name."
|
||
|
|
},
|
||
|
|
"list": {
|
||
|
|
"id": "firebaserules.projects.releases.list",
|
||
|
|
"path": "v1/{+name}/releases",
|
||
|
|
"description": "List the `Release` values for a project. This list may optionally be\nfiltered by `Release` name, `Ruleset` name, `TestSuite` name, or any\ncombination thereof.",
|
||
|
|
"httpMethod": "GET",
|
||
|
|
"response": {
|
||
|
|
"$ref": "ListReleasesResponse"
|
||
|
|
},
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase",
|
||
|
|
"https://www.googleapis.com/auth/firebase.readonly"
|
||
|
|
],
|
||
|
|
"parameters": {
|
||
|
|
"name": {
|
||
|
|
"required": true,
|
||
|
|
"type": "string",
|
||
|
|
"pattern": "^projects/[^/]+$",
|
||
|
|
"location": "path",
|
||
|
|
"description": "Resource name for the project.\n\nFormat: `projects/{project_id}`"
|
||
|
|
},
|
||
|
|
"pageToken": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "Next page token for the next batch of `Release` instances.",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"pageSize": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "Page size to load. Maximum of 100. Defaults to 10.\nNote: `page_size` is just a hint and the service may choose to load fewer\nthan `page_size` results due to the size of the output. To traverse all of\nthe releases, the caller should iterate until the `page_token` on the\nresponse is empty.",
|
||
|
|
"format": "int32",
|
||
|
|
"type": "integer"
|
||
|
|
},
|
||
|
|
"filter": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "`Release` filter. The list method supports filters with restrictions on the\n`Release.name`, `Release.ruleset_name`, and `Release.test_suite_name`.\n\nExample 1: A filter of 'name=prod*' might return `Release`s with names\nwithin 'projects/foo' prefixed with 'prod':\n\nName | Ruleset Name\n------------------------------|-------------\nprojects/foo/releases/prod | projects/foo/rulesets/uuid1234\nprojects/foo/releases/prod/v1 | projects/foo/rulesets/uuid1234\nprojects/foo/releases/prod/v2 | projects/foo/rulesets/uuid8888\n\nExample 2: A filter of `name=prod* ruleset_name=uuid1234` would return only\n`Release` instances for 'projects/foo' with names prefixed with 'prod'\nreferring to the same `Ruleset` name of 'uuid1234':\n\nName | Ruleset Name\n------------------------------|-------------\nprojects/foo/releases/prod | projects/foo/rulesets/1234\nprojects/foo/releases/prod/v1 | projects/foo/rulesets/1234\n\nIn the examples, the filter parameters refer to the search filters are\nrelative to the project. Fully qualified prefixed may also be used. e.g.\n`test_suite_name=projects/foo/testsuites/uuid1`",
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"flatPath": "v1/projects/{projectsId}/releases"
|
||
|
|
},
|
||
|
|
"update": {
|
||
|
|
"httpMethod": "PUT",
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"response": {
|
||
|
|
"$ref": "Release"
|
||
|
|
},
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase"
|
||
|
|
],
|
||
|
|
"parameters": {
|
||
|
|
"name": {
|
||
|
|
"description": "Resource name for the `Release`.\n\n`Release` names may be structured `app1/prod/v2` or flat `app1_prod_v2`\nwhich affords developers a great deal of flexibility in mapping the name\nto the style that best fits their existing development practices. For\nexample, a name could refer to an environment, an app, a version, or some\ncombination of three.\n\nIn the table below, for the project name `projects/foo`, the following\nrelative release paths show how flat and structured names might be chosen\nto match a desired development / deployment strategy.\n\nUse Case | Flat Name | Structured Name\n-------------|---------------------|----------------\nEnvironments | releases/qa | releases/qa\nApps | releases/app1_qa | releases/app1/qa\nVersions | releases/app1_v2_qa | releases/app1/v2/qa\n\nThe delimiter between the release name path elements can be almost anything\nand it should work equally well with the release name list filter, but in\nmany ways the structured paths provide a clearer picture of the\nrelationship between `Release` instances.\n\nFormat: `projects/{project_id}/releases/{release_id}`",
|
||
|
|
"required": true,
|
||
|
|
"type": "string",
|
||
|
|
"pattern": "^projects/[^/]+/releases/.+$",
|
||
|
|
"location": "path"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"flatPath": "v1/projects/{projectsId}/releases/{releasesId}",
|
||
|
|
"id": "firebaserules.projects.releases.update",
|
||
|
|
"path": "v1/{+name}",
|
||
|
|
"description": "Update a `Release`.\n\nOnly updates to the `ruleset_name` and `test_suite_name` fields will be\nhonored. `Release` rename is not supported. To create a `Release` use the\nCreateRelease method.",
|
||
|
|
"request": {
|
||
|
|
"$ref": "Release"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"create": {
|
||
|
|
"response": {
|
||
|
|
"$ref": "Release"
|
||
|
|
},
|
||
|
|
"parameterOrder": [
|
||
|
|
"name"
|
||
|
|
],
|
||
|
|
"httpMethod": "POST",
|
||
|
|
"parameters": {
|
||
|
|
"name": {
|
||
|
|
"location": "path",
|
||
|
|
"description": "Resource name for the project which owns this `Release`.\n\nFormat: `projects/{project_id}`",
|
||
|
|
"required": true,
|
||
|
|
"type": "string",
|
||
|
|
"pattern": "^projects/[^/]+$"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"scopes": [
|
||
|
|
"https://www.googleapis.com/auth/cloud-platform",
|
||
|
|
"https://www.googleapis.com/auth/firebase"
|
||
|
|
],
|
||
|
|
"flatPath": "v1/projects/{projectsId}/releases",
|
||
|
|
"path": "v1/{+name}/releases",
|
||
|
|
"id": "firebaserules.projects.releases.create",
|
||
|
|
"request": {
|
||
|
|
"$ref": "Release"
|
||
|
|
},
|
||
|
|
"description": "Create a `Release`.\n\nRelease names should reflect the developer's deployment practices. For\nexample, the release name may include the environment name, application\nname, application version, or any other name meaningful to the developer.\nOnce a `Release` refers to a `Ruleset`, the rules can be enforced by\nFirebase Rules-enabled services.\n\nMore than one `Release` may be 'live' concurrently. Consider the following\nthree `Release` names for `projects/foo` and the `Ruleset` to which they\nrefer.\n\nRelease Name | Ruleset Name\n--------------------------------|-------------\nprojects/foo/releases/prod | projects/foo/rulesets/uuid123\nprojects/foo/releases/prod/beta | projects/foo/rulesets/uuid123\nprojects/foo/releases/prod/v23 | projects/foo/rulesets/uuid456\n\nThe table reflects the `Ruleset` rollout in progress. The `prod` and\n`prod/beta` releases refer to the same `Ruleset`. However, `prod/v23`\nrefers to a new `Ruleset`. The `Ruleset` reference for a `Release` may be\nupdated using the UpdateRelease method."
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"parameters": {
|
||
|
|
"pp": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "Pretty-print response.",
|
||
|
|
"type": "boolean",
|
||
|
|
"default": "true"
|
||
|
|
},
|
||
|
|
"oauth_token": {
|
||
|
|
"description": "OAuth 2.0 token for the current user.",
|
||
|
|
"type": "string",
|
||
|
|
"location": "query"
|
||
|
|
},
|
||
|
|
"bearer_token": {
|
||
|
|
"description": "OAuth bearer token.",
|
||
|
|
"type": "string",
|
||
|
|
"location": "query"
|
||
|
|
},
|
||
|
|
"upload_protocol": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"prettyPrint": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "Returns response with indentations and line breaks.",
|
||
|
|
"type": "boolean",
|
||
|
|
"default": "true"
|
||
|
|
},
|
||
|
|
"uploadType": {
|
||
|
|
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
|
||
|
|
"type": "string",
|
||
|
|
"location": "query"
|
||
|
|
},
|
||
|
|
"fields": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "Selector specifying which fields to include in a partial response.",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"$.xgafv": {
|
||
|
|
"enumDescriptions": [
|
||
|
|
"v1 error format",
|
||
|
|
"v2 error format"
|
||
|
|
],
|
||
|
|
"location": "query",
|
||
|
|
"enum": [
|
||
|
|
"1",
|
||
|
|
"2"
|
||
|
|
],
|
||
|
|
"description": "V1 error format.",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"callback": {
|
||
|
|
"type": "string",
|
||
|
|
"location": "query",
|
||
|
|
"description": "JSONP"
|
||
|
|
},
|
||
|
|
"alt": {
|
||
|
|
"description": "Data format for response.",
|
||
|
|
"default": "json",
|
||
|
|
"enum": [
|
||
|
|
"json",
|
||
|
|
"media",
|
||
|
|
"proto"
|
||
|
|
],
|
||
|
|
"type": "string",
|
||
|
|
"enumDescriptions": [
|
||
|
|
"Responses with Content-Type of application/json",
|
||
|
|
"Media download with context-dependent Content-Type",
|
||
|
|
"Responses with Content-Type of application/x-protobuf"
|
||
|
|
],
|
||
|
|
"location": "query"
|
||
|
|
},
|
||
|
|
"access_token": {
|
||
|
|
"type": "string",
|
||
|
|
"location": "query",
|
||
|
|
"description": "OAuth access token."
|
||
|
|
},
|
||
|
|
"key": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
|
||
|
|
"type": "string"
|
||
|
|
},
|
||
|
|
"quotaUser": {
|
||
|
|
"location": "query",
|
||
|
|
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
|
||
|
|
"type": "string"
|
||
|
|
}
|
||
|
|
},
|
||
|
|
"version": "v1",
|
||
|
|
"baseUrl": "https://firebaserules.googleapis.com/",
|
||
|
|
"servicePath": "",
|
||
|
|
"description": "Creates and manages rules that determine when a Firebase Rules-enabled service should permit a request.\n",
|
||
|
|
"kind": "discovery#restDescription",
|
||
|
|
"basePath": "",
|
||
|
|
"revision": "20170418",
|
||
|
|
"documentationLink": "https://firebase.google.com/docs/storage/security",
|
||
|
|
"id": "firebaserules:v1"
|
||
|
|
}
|