@origincloud/billing 0.27.0 → 0.28.0

package/dist/v1beta1/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./billing_account.js";
 export * from "./cost.js";
+export * from "./legal_acceptance.js";
 export * from "./legal_document.js";
 export * from "./price_list.js";
 export * from "./spend_limit.js";

package/dist/v1beta1/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1beta1/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1beta1/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/v1beta1/index.js

@@ -1,6 +1,7 @@
 // Code generated by the SDK's generator (generator/). DO NOT EDIT.
 export * from "./billing_account.js";
 export * from "./cost.js";
+export * from "./legal_acceptance.js";
 export * from "./legal_document.js";
 export * from "./price_list.js";
 export * from "./spend_limit.js";

package/dist/v1beta1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1beta1/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1beta1/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/v1beta1/legal_acceptance.d.ts

@@ -0,0 +1,194 @@
+import { type CalendarDate, type CallOptions, type Client, type Service } from "@origincloud/core";
+import type { BillingAddress } from "./billing_account.js";
+/**
+ * Calls LegalAcceptanceService.
+ *
+ * A billing account's acceptances of the legal documents customers accept:
+ * the Terms of Service, the Data Processing Agreement, the Service Level
+ * Agreement and the Acceptable Use Policy. The billing account is the legal
+ * entity that accepts. An acceptance is a record that never changes, and it
+ * is kept after the billing account and its organization are deleted.
+ */
+export declare class LegalAcceptanceClient {
+    /**
+     * The endpoint the client sends its calls to, which also serves the
+     * operations its methods answer with.
+     */
+    readonly service: Service;
+    /** A client of LegalAcceptanceService that sends its calls through `client`. */
+    constructor(client: Client);
+    /**
+     * Lists a billing account's acceptances, the latest first. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    listLegalAcceptances(request: ListLegalAcceptancesRequest, options?: CallOptions): Promise<ListLegalAcceptancesResponse>;
+    /**
+     * Iterates over everything listLegalAcceptances lists from the request's page on,
+     * fetching the next page as the loop reaches it. A page that fails ends
+     * the iteration with its error.
+     */
+    allLegalAcceptances(request: ListLegalAcceptancesRequest, options?: CallOptions): AsyncGenerator<LegalAcceptance, void, undefined>;
+    /**
+     * Returns one of a billing account's acceptances. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    getLegalAcceptance(request: GetLegalAcceptanceRequest, options?: CallOptions): Promise<LegalAcceptance>;
+    /**
+     * Accepts versions of legal documents for a billing account, all of them
+     * or none. Each version is named with the `sha256` of the text the caller
+     * showed, and must be the version in force or one published to take effect
+     * later. A version the account accepted before is returned as it was then.
+     * `actsAsBusiness` must be true: the services are offered to businesses
+     * only. Needs `admin.billing_account.update` on the organization.
+     */
+    acceptLegalDocuments(request: AcceptLegalDocumentsRequest, options?: CallOptions): Promise<ListLegalAcceptancesResponse>;
+    /**
+     * Returns the legal document versions a billing account has yet to
+     * accept. A version is `blocking` once it is in force: until the account
+     * accepts it, creating or growing billable resources charged to the
+     * account is refused. Running resources are never affected. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    queryLegalRequirements(request: QueryLegalRequirementsRequest, options?: CallOptions): Promise<QueryLegalRequirementsResponse>;
+}
+/** A billing account's acceptance of one version of a legal document. */
+export interface LegalAcceptance {
+    /** The acceptance's resource name. */
+    name?: string;
+    /**
+     * The version accepted,
+     * `legalDocuments/{legal_document}/versions/{version}`.
+     */
+    legalDocumentVersion?: string;
+    /** The SHA-256 of the text accepted: the version's `sha256`. */
+    sha256?: string;
+    /**
+     * Who accepted: `user:{id}`, or `service_account:{id}` for a service
+     * account.
+     */
+    accepter?: string;
+    /** When the version was accepted. */
+    acceptTime?: string;
+    /** How the acceptance came about. */
+    method?: LegalAcceptance_Method;
+    /** Whether the accepter confirmed acting as a business. Always true. */
+    actsAsBusiness?: boolean;
+    /**
+     * The legal entity that accepted, as it was at `acceptTime`: the
+     * organization's name.
+     */
+    organizationDisplayName?: string;
+    /**
+     * The billing account's address at `acceptTime`; unset for an account
+     * that had none.
+     */
+    billingAddress?: BillingAddress;
+    /**
+     * The billing account's VAT identification number at `acceptTime`;
+     * empty when it had none.
+     */
+    vatId?: string;
+}
+/** How the acceptance came about. */
+export declare const LegalAcceptance_Method: {
+    /** Not used. */
+    readonly METHOD_UNSPECIFIED: "METHOD_UNSPECIFIED";
+    /** When the organization or the billing account was created. */
+    readonly SIGNUP: "SIGNUP";
+    /** A changed version of a document the account had accepted before. */
+    readonly CHANGE: "CHANGE";
+    /**
+     * The first version of a document, by an account that existed before
+     * the document was published.
+     */
+    readonly MIGRATION: "MIGRATION";
+};
+/** How the acceptance came about. */
+export type LegalAcceptance_Method = (typeof LegalAcceptance_Method)[keyof typeof LegalAcceptance_Method];
+/** A legal document version a billing account has yet to accept. */
+export interface LegalRequirement {
+    /** The version, `legalDocuments/{legal_document}/versions/{version}`. */
+    legalDocumentVersion?: string;
+    /** The version's title, such as `Terms of Service`. */
+    displayName?: string;
+    /** The day the version takes effect. */
+    effectiveDate?: CalendarDate;
+    /** A plain-language summary of what changed. */
+    changeSummary?: string;
+    /** The version's `sha256`, to accept it by. */
+    sha256?: string;
+    /**
+     * In force already: until it is accepted, creating or growing billable
+     * resources charged to the account is refused.
+     */
+    blocking?: boolean;
+}
+/** A version to accept, with the text it was shown as. */
+export interface LegalDocumentVersionToAccept {
+    /** The version, `legalDocuments/{legal_document}/versions/{version}`. */
+    legalDocumentVersion?: string;
+    /**
+     * The version's `sha256`, as read with it: an acceptance is refused when
+     * the text shown isn't the version's.
+     */
+    sha256?: string;
+}
+/** The request for ListLegalAcceptances. */
+export interface ListLegalAcceptancesRequest {
+    /**
+     * The billing account,
+     * `organizations/{organization}/billingAccounts/{billing_account}`.
+     */
+    parent?: string;
+    /**
+     * The most acceptances to return; the server clamps it, and 0 means its
+     * default.
+     */
+    pageSize?: number;
+    /** A previous response's `nextPageToken`, for the page after it. */
+    pageToken?: string;
+}
+/** The response for ListLegalAcceptances and AcceptLegalDocuments. */
+export interface ListLegalAcceptancesResponse {
+    /**
+     * The acceptances on this page; for AcceptLegalDocuments, one per version
+     * accepted, in the order requested.
+     */
+    legalAcceptances?: LegalAcceptance[];
+    /** The token for the next page; empty on the last one. */
+    nextPageToken?: string;
+}
+/** The request for GetLegalAcceptance. */
+export interface GetLegalAcceptanceRequest {
+    /** The acceptance to return. */
+    name?: string;
+}
+/** The request for AcceptLegalDocuments. */
+export interface AcceptLegalDocumentsRequest {
+    /**
+     * The billing account that accepts,
+     * `organizations/{organization}/billingAccounts/{billing_account}`.
+     */
+    name?: string;
+    /** The versions to accept. */
+    versions?: LegalDocumentVersionToAccept[];
+    /**
+     * That the caller acts as a business (§ 14 BGB) for the billing account's
+     * legal entity. Must be true.
+     */
+    actsAsBusiness?: boolean;
+}
+/** The request for QueryLegalRequirements. */
+export interface QueryLegalRequirementsRequest {
+    /**
+     * The billing account,
+     * `organizations/{organization}/billingAccounts/{billing_account}`.
+     */
+    name?: string;
+}
+/** The response for QueryLegalRequirements. */
+export interface QueryLegalRequirementsResponse {
+    /** The versions to accept, by document, then by the day they take effect. */
+    requirements?: LegalRequirement[];
+}
+//# sourceMappingURL=legal_acceptance.d.ts.map

package/dist/v1beta1/legal_acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legal_acceptance.d.ts","sourceRoot":"","sources":["../../src/v1beta1/legal_acceptance.ts"],"names":[],"mappings":"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"}

package/dist/v1beta1/legal_acceptance.js

@@ -0,0 +1,111 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/billing/v1beta1/legal_acceptance.proto
+import { pathValue, query, } from "@origincloud/core";
+/**
+ * Calls LegalAcceptanceService.
+ *
+ * A billing account's acceptances of the legal documents customers accept:
+ * the Terms of Service, the Data Processing Agreement, the Service Level
+ * Agreement and the Acceptable Use Policy. The billing account is the legal
+ * entity that accepts. An acceptance is a record that never changes, and it
+ * is kept after the billing account and its organization are deleted.
+ */
+export class LegalAcceptanceClient {
+    /**
+     * The endpoint the client sends its calls to, which also serves the
+     * operations its methods answer with.
+     */
+    service;
+    /** A client of LegalAcceptanceService that sends its calls through `client`. */
+    constructor(client) {
+        this.service = client.service("billing", false);
+    }
+    /**
+     * Lists a billing account's acceptances, the latest first. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    async listLegalAcceptances(request, options) {
+        const p0 = pathValue("parent", request.parent, "organizations/*/billingAccounts/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}/legalAcceptances`,
+            query: query(request, ["parent"]),
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Iterates over everything listLegalAcceptances lists from the request's page on,
+     * fetching the next page as the loop reaches it. A page that fails ends
+     * the iteration with its error.
+     */
+    async *allLegalAcceptances(request, options) {
+        for (let page = request;;) {
+            const response = await this.listLegalAcceptances(page, options);
+            yield* response.legalAcceptances ?? [];
+            if (!response.nextPageToken)
+                return;
+            page = { ...page, pageToken: response.nextPageToken };
+        }
+    }
+    /**
+     * Returns one of a billing account's acceptances. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    async getLegalAcceptance(request, options) {
+        const p0 = pathValue("name", request.name, "organizations/*/billingAccounts/*/legalAcceptances/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}`,
+            query: query(request, ["name"]),
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Accepts versions of legal documents for a billing account, all of them
+     * or none. Each version is named with the `sha256` of the text the caller
+     * showed, and must be the version in force or one published to take effect
+     * later. A version the account accepted before is returned as it was then.
+     * `actsAsBusiness` must be true: the services are offered to businesses
+     * only. Needs `admin.billing_account.update` on the organization.
+     */
+    async acceptLegalDocuments(request, options) {
+        const p0 = pathValue("name", request.name, "organizations/*/billingAccounts/*");
+        return this.service.call({
+            method: "POST",
+            path: `/v1beta1/${p0}:acceptLegalDocuments`,
+            body: request,
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Returns the legal document versions a billing account has yet to
+     * accept. A version is `blocking` once it is in force: until the account
+     * accepts it, creating or growing billable resources charged to the
+     * account is refused. Running resources are never affected. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    async queryLegalRequirements(request, options) {
+        const p0 = pathValue("name", request.name, "organizations/*/billingAccounts/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}:queryLegalRequirements`,
+            query: query(request, ["name"]),
+            idempotent: true,
+        }, options);
+    }
+}
+/** How the acceptance came about. */
+export const LegalAcceptance_Method = {
+    /** Not used. */
+    METHOD_UNSPECIFIED: "METHOD_UNSPECIFIED",
+    /** When the organization or the billing account was created. */
+    SIGNUP: "SIGNUP",
+    /** A changed version of a document the account had accepted before. */
+    CHANGE: "CHANGE",
+    /**
+     * The first version of a document, by an account that existed before
+     * the document was published.
+     */
+    MIGRATION: "MIGRATION",
+};
+//# sourceMappingURL=legal_acceptance.js.map

package/dist/v1beta1/legal_acceptance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legal_acceptance.js","sourceRoot":"","sources":["../../src/v1beta1/legal_acceptance.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@origincloud/billing",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Origin Cloud's billing service: billing accounts and the projects they pay for, payment methods, cost and usage, spend limits and the price list.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/origincloudhq/sdk-typescript#readme",
@@ -34,9 +34,9 @@
     "!dist/**/*.tsbuildinfo"
   ],
   "peerDependencies": {
-    "@origincloud/core": "^0.27.0"
+    "@origincloud/core": "^0.28.0"
   },
   "devDependencies": {
-    "@origincloud/core": "^0.27.0"
+    "@origincloud/core": "^0.28.0"
   }
 }

package/src/v1beta1/index.ts

@@ -2,6 +2,7 @@
 
 export * from "./billing_account.js";
 export * from "./cost.js";
+export * from "./legal_acceptance.js";
 export * from "./legal_document.js";
 export * from "./price_list.js";
 export * from "./spend_limit.js";

package/src/v1beta1/legal_acceptance.ts

@@ -0,0 +1,274 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/billing/v1beta1/legal_acceptance.proto
+
+import {
+  type CalendarDate,
+  type CallOptions,
+  type Client,
+  type Service,
+  pathValue,
+  query,
+} from "@origincloud/core";
+import type { BillingAddress } from "./billing_account.js";
+
+/**
+ * Calls LegalAcceptanceService.
+ *
+ * A billing account's acceptances of the legal documents customers accept:
+ * the Terms of Service, the Data Processing Agreement, the Service Level
+ * Agreement and the Acceptable Use Policy. The billing account is the legal
+ * entity that accepts. An acceptance is a record that never changes, and it
+ * is kept after the billing account and its organization are deleted.
+ */
+export class LegalAcceptanceClient {
+  /**
+   * The endpoint the client sends its calls to, which also serves the
+   * operations its methods answer with.
+   */
+  readonly service: Service;
+
+  /** A client of LegalAcceptanceService that sends its calls through `client`. */
+  constructor(client: Client) {
+    this.service = client.service("billing", false);
+  }
+
+  /**
+   * Lists a billing account's acceptances, the latest first. Needs
+   * `admin.billing_account.get` on the organization.
+   */
+  async listLegalAcceptances(request: ListLegalAcceptancesRequest, options?: CallOptions): Promise<ListLegalAcceptancesResponse> {
+    const p0 = pathValue("parent", request.parent, "organizations/*/billingAccounts/*");
+    return this.service.call<ListLegalAcceptancesResponse>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}/legalAcceptances`,
+        query: query(request, ["parent"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Iterates over everything listLegalAcceptances lists from the request's page on,
+   * fetching the next page as the loop reaches it. A page that fails ends
+   * the iteration with its error.
+   */
+  async *allLegalAcceptances(request: ListLegalAcceptancesRequest, options?: CallOptions): AsyncGenerator<LegalAcceptance, void, undefined> {
+    for (let page = request; ; ) {
+      const response = await this.listLegalAcceptances(page, options);
+      yield* response.legalAcceptances ?? [];
+      if (!response.nextPageToken) return;
+      page = { ...page, pageToken: response.nextPageToken };
+    }
+  }
+
+  /**
+   * Returns one of a billing account's acceptances. Needs
+   * `admin.billing_account.get` on the organization.
+   */
+  async getLegalAcceptance(request: GetLegalAcceptanceRequest, options?: CallOptions): Promise<LegalAcceptance> {
+    const p0 = pathValue("name", request.name, "organizations/*/billingAccounts/*/legalAcceptances/*");
+    return this.service.call<LegalAcceptance>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}`,
+        query: query(request, ["name"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Accepts versions of legal documents for a billing account, all of them
+   * or none. Each version is named with the `sha256` of the text the caller
+   * showed, and must be the version in force or one published to take effect
+   * later. A version the account accepted before is returned as it was then.
+   * `actsAsBusiness` must be true: the services are offered to businesses
+   * only. Needs `admin.billing_account.update` on the organization.
+   */
+  async acceptLegalDocuments(request: AcceptLegalDocumentsRequest, options?: CallOptions): Promise<ListLegalAcceptancesResponse> {
+    const p0 = pathValue("name", request.name, "organizations/*/billingAccounts/*");
+    return this.service.call<ListLegalAcceptancesResponse>(
+      {
+        method: "POST",
+        path: `/v1beta1/${p0}:acceptLegalDocuments`,
+        body: request,
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Returns the legal document versions a billing account has yet to
+   * accept. A version is `blocking` once it is in force: until the account
+   * accepts it, creating or growing billable resources charged to the
+   * account is refused. Running resources are never affected. Needs
+   * `admin.billing_account.get` on the organization.
+   */
+  async queryLegalRequirements(request: QueryLegalRequirementsRequest, options?: CallOptions): Promise<QueryLegalRequirementsResponse> {
+    const p0 = pathValue("name", request.name, "organizations/*/billingAccounts/*");
+    return this.service.call<QueryLegalRequirementsResponse>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}:queryLegalRequirements`,
+        query: query(request, ["name"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+}
+
+/** A billing account's acceptance of one version of a legal document. */
+export interface LegalAcceptance {
+  /** The acceptance's resource name. */
+  name?: string;
+  /**
+   * The version accepted,
+   * `legalDocuments/{legal_document}/versions/{version}`.
+   */
+  legalDocumentVersion?: string;
+  /** The SHA-256 of the text accepted: the version's `sha256`. */
+  sha256?: string;
+  /**
+   * Who accepted: `user:{id}`, or `service_account:{id}` for a service
+   * account.
+   */
+  accepter?: string;
+  /** When the version was accepted. */
+  acceptTime?: string;
+  /** How the acceptance came about. */
+  method?: LegalAcceptance_Method;
+  /** Whether the accepter confirmed acting as a business. Always true. */
+  actsAsBusiness?: boolean;
+  /**
+   * The legal entity that accepted, as it was at `acceptTime`: the
+   * organization's name.
+   */
+  organizationDisplayName?: string;
+  /**
+   * The billing account's address at `acceptTime`; unset for an account
+   * that had none.
+   */
+  billingAddress?: BillingAddress;
+  /**
+   * The billing account's VAT identification number at `acceptTime`;
+   * empty when it had none.
+   */
+  vatId?: string;
+}
+
+/** How the acceptance came about. */
+export const LegalAcceptance_Method = {
+  /** Not used. */
+  METHOD_UNSPECIFIED: "METHOD_UNSPECIFIED",
+  /** When the organization or the billing account was created. */
+  SIGNUP: "SIGNUP",
+  /** A changed version of a document the account had accepted before. */
+  CHANGE: "CHANGE",
+  /**
+   * The first version of a document, by an account that existed before
+   * the document was published.
+   */
+  MIGRATION: "MIGRATION",
+} as const;
+
+/** How the acceptance came about. */
+export type LegalAcceptance_Method = (typeof LegalAcceptance_Method)[keyof typeof LegalAcceptance_Method];
+
+/** A legal document version a billing account has yet to accept. */
+export interface LegalRequirement {
+  /** The version, `legalDocuments/{legal_document}/versions/{version}`. */
+  legalDocumentVersion?: string;
+  /** The version's title, such as `Terms of Service`. */
+  displayName?: string;
+  /** The day the version takes effect. */
+  effectiveDate?: CalendarDate;
+  /** A plain-language summary of what changed. */
+  changeSummary?: string;
+  /** The version's `sha256`, to accept it by. */
+  sha256?: string;
+  /**
+   * In force already: until it is accepted, creating or growing billable
+   * resources charged to the account is refused.
+   */
+  blocking?: boolean;
+}
+
+/** A version to accept, with the text it was shown as. */
+export interface LegalDocumentVersionToAccept {
+  /** The version, `legalDocuments/{legal_document}/versions/{version}`. */
+  legalDocumentVersion?: string;
+  /**
+   * The version's `sha256`, as read with it: an acceptance is refused when
+   * the text shown isn't the version's.
+   */
+  sha256?: string;
+}
+
+/** The request for ListLegalAcceptances. */
+export interface ListLegalAcceptancesRequest {
+  /**
+   * The billing account,
+   * `organizations/{organization}/billingAccounts/{billing_account}`.
+   */
+  parent?: string;
+  /**
+   * The most acceptances to return; the server clamps it, and 0 means its
+   * default.
+   */
+  pageSize?: number;
+  /** A previous response's `nextPageToken`, for the page after it. */
+  pageToken?: string;
+}
+
+/** The response for ListLegalAcceptances and AcceptLegalDocuments. */
+export interface ListLegalAcceptancesResponse {
+  /**
+   * The acceptances on this page; for AcceptLegalDocuments, one per version
+   * accepted, in the order requested.
+   */
+  legalAcceptances?: LegalAcceptance[];
+  /** The token for the next page; empty on the last one. */
+  nextPageToken?: string;
+}
+
+/** The request for GetLegalAcceptance. */
+export interface GetLegalAcceptanceRequest {
+  /** The acceptance to return. */
+  name?: string;
+}
+
+/** The request for AcceptLegalDocuments. */
+export interface AcceptLegalDocumentsRequest {
+  /**
+   * The billing account that accepts,
+   * `organizations/{organization}/billingAccounts/{billing_account}`.
+   */
+  name?: string;
+  /** The versions to accept. */
+  versions?: LegalDocumentVersionToAccept[];
+  /**
+   * That the caller acts as a business (§ 14 BGB) for the billing account's
+   * legal entity. Must be true.
+   */
+  actsAsBusiness?: boolean;
+}
+
+/** The request for QueryLegalRequirements. */
+export interface QueryLegalRequirementsRequest {
+  /**
+   * The billing account,
+   * `organizations/{organization}/billingAccounts/{billing_account}`.
+   */
+  name?: string;
+}
+
+/** The response for QueryLegalRequirements. */
+export interface QueryLegalRequirementsResponse {
+  /** The versions to accept, by document, then by the day they take effect. */
+  requirements?: LegalRequirement[];
+}