com.google.api.usage

Members list

Type members

Classlikes

final case class Usage(requirements: Seq[String], rules: Seq[UsageRule], producerNotificationChannel: String, unknownFields: UnknownFieldSet) extends GeneratedMessage, Updatable[Usage]

Configuration controlling usage of a service.

Configuration controlling usage of a service.

Value parameters

producerNotificationChannel

The full resource name of a channel used for sending notifications to the service producer. Google Service Management currently only supports [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. To use Google Cloud Pub/Sub as the channel, this must be the name of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format documented in https://cloud.google.com/pubsub/docs/overview.

requirements

Requirements that must be satisfied before a consumer project can use the service. Each requirement is of the form <service.name>/<requirement-id>; for example 'serviceusage.googleapis.com/billing-enabled'. For Google APIs, a Terms of Service requirement must be included here. Google Cloud APIs must include "serviceusage.googleapis.com/tos/cloud". Other Google APIs should include "serviceusage.googleapis.com/tos/universal". Additional ToS can be included based on the business needs.

rules

A list of usage rules that apply to individual API methods. **NOTE:** All service configuration rules follow "last one wins" order.

Attributes

Companion
object
Source
Usage.scala
Supertypes
trait Updatable[Usage]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
object Usage extends GeneratedMessageCompanion[Usage]

Attributes

Companion
class
Source
Usage.scala
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[Usage]
trait Serializable
class Object
trait Matchable
class Any
Show all
Self type
Usage.type
object UsageProto extends GeneratedFileObject

Attributes

Source
UsageProto.scala
Supertypes
class GeneratedFileObject
class Object
trait Matchable
class Any
Self type
UsageProto.type
final case class UsageRule(selector: String, allowUnregisteredCalls: Boolean, skipServiceControl: Boolean, unknownFields: UnknownFieldSet) extends GeneratedMessage, Updatable[UsageRule]

Usage configuration rules for the service.

Usage configuration rules for the service.

NOTE: Under development.

Use this rule to configure unregistered calls for the service. Unregistered calls are calls that do not contain consumer project identity. (Example: calls that do not contain an API key). By default, API methods do not allow unregistered calls, and each method call must be identified by a consumer project identity. Use this rule to allow/disallow unregistered calls.

Example of an API that wants to allow unregistered calls for entire service.

usage: rules:

  • selector: "*" allow_unregistered_calls: true

Example of a method that wants to allow unregistered calls.

usage: rules:

  • selector: "google.example.library.v1.LibraryService.CreateBook" allow_unregistered_calls: true

Value parameters

allowUnregisteredCalls

If true, the selected method allows unregistered calls, e.g. calls that don't identify any user or application.

selector

Selects the methods to which this rule applies. Use '*' to indicate all methods in all APIs. Refer to [selector][google.api.DocumentationRule.selector] for syntax details.

skipServiceControl

If true, the selected method should skip service control and the control plane features, such as quota and billing, will not be available. This flag is used by Google Cloud Endpoints to bypass checks for internal methods, such as service health check methods.

Attributes

Companion
object
Source
UsageRule.scala
Supertypes
trait Updatable[UsageRule]
trait GeneratedMessage
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
object UsageRule extends GeneratedMessageCompanion[UsageRule]

Attributes

Companion
class
Source
UsageRule.scala
Supertypes
trait Product
trait Mirror
trait GeneratedMessageCompanion[UsageRule]
trait Serializable
class Object
trait Matchable
class Any
Show all
Self type
UsageRule.type