/**  Configuration controlling usage of a service. */
export interface Usage {
    /**
     *  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.
     */
    requirements?: string[]

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

    /**
     *  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.
     */
    producerNotificationChannel?: string
}

export namespace Usage {
    export const name = 'google.api.Usage'
}

/**
 *  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
 */
export interface UsageRule {
    /**
     *  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.
     */
    selector?: string

    /**
     *  If true, the selected method allows unregistered calls, e.g. calls
     *  that don't identify any user or application.
     */
    allowUnregisteredCalls?: boolean

    /**
     *  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.
     */
    skipServiceControl?: boolean
}

export namespace UsageRule {
    export const name = 'google.api.UsageRule'
}