Google Admin SDK Admin Sdk Admin Directory Domains API

openapi: 3.1.0
info:
  title: Admin SDK API Domains API
  version: directory_v1
  description: Generated from Google's published Discovery document for Admin SDK API (admin directory_v1, revision 20261109).
    4 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
externalDocs:
  url: https://developers.google.com/workspace/admin/
servers:
- url: https://admin.googleapis.com
paths:
  /admin/directory/v1/customer/{customer}/domains/{domainName}:
    delete:
      operationId: directory.domains.delete
      summary: Delete domains
      description: Deletes a domain of the customer.
      parameters:
      - name: customer
        in: path
        required: true
        description: Immutable ID of the Google Workspace account.
        schema:
          type: string
      - name: domainName
        in: path
        required: true
        description: Name of domain to be deleted
        schema:
          type: string
      responses:
        '200':
          description: Successful response
        4XX:
          content: &id001
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content: *id001
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/admin.directory.domain
      - apiKey: []
      tags:
      - Domains
    get:
      operationId: directory.domains.get
      summary: Get domains
      description: Retrieves a domain of the customer.
      parameters:
      - name: customer
        in: path
        required: true
        description: The unique ID for the customer's Google Workspace account. In case of a multi-domain account, to fetch
          all groups for a customer, use this field instead of `domain`. You can also use the `my_customer` alias to represent
          your account's `customerId`. The `customerId` is also returned as part of the [Users](https://developers.google.com/workspace/admin/directory/v1/reference/users)
          resource. You must provide either the `customer` or the `domain` parameter.
        schema:
          type: string
      - name: domainName
        in: path
        required: true
        description: Name of domain to be retrieved
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Domains'
        4XX:
          content: &id002
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content: *id002
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/admin.directory.domain
        - https://www.googleapis.com/auth/admin.directory.domain.readonly
      - apiKey: []
      tags:
      - Domains
  /admin/directory/v1/customer/{customer}/domains:
    get:
      operationId: directory.domains.list
      summary: List domains
      description: Lists the domains of the customer.
      parameters:
      - name: customer
        in: path
        required: true
        description: The unique ID for the customer's Google Workspace account. In case of a multi-domain account, to fetch
          all groups for a customer, use this field instead of `domain`. You can also use the `my_customer` alias to represent
          your account's `customerId`. The `customerId` is also returned as part of the [Users](https://developers.google.com/workspace/admin/directory/v1/reference/users)
          resource. You must provide either the `customer` or the `domain` parameter.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Domains2'
        4XX:
          content: &id003
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content: *id003
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/admin.directory.domain
        - https://www.googleapis.com/auth/admin.directory.domain.readonly
      - apiKey: []
      tags:
      - Domains
    post:
      operationId: directory.domains.insert
      summary: Insert domains
      description: Inserts a domain of the customer.
      parameters:
      - name: customer
        in: path
        required: true
        description: Immutable ID of the Google Workspace account.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Domains'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Domains'
        4XX:
          content: &id004
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content: *id004
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/admin.directory.domain
      - apiKey: []
      tags:
      - Domains
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/admin.directory.userschema: View and manage the provisioning of user schemas on
              your domain
            https://www.googleapis.com/auth/admin.directory.group.readonly: View groups on your domain
            https://www.googleapis.com/auth/admin.directory.resource.calendar: View and manage the provisioning of calendar
              resources on your domain
            https://www.googleapis.com/auth/admin.directory.domain.readonly: View domains related to your customers
            https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly: View your ChromeOS devices' metadata
            https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly: View calendar resources on your domain
            https://www.googleapis.com/auth/admin.directory.device.mobile.readonly: View your mobile devices' metadata
            https://www.googleapis.com/auth/admin.chrome.printers.readonly: See the printers that your organization can use
              with Chrome
            https://www.googleapis.com/auth/admin.directory.user.alias.readonly: View user aliases on your domain
            https://www.googleapis.com/auth/admin.chrome.printers: See, add, edit, and permanently delete the printers that
              your organization can use with Chrome
            https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly: View delegated admin roles for your domain
            https://www.googleapis.com/auth/admin.directory.user: View and manage the provisioning of users on your domain
            https://www.googleapis.com/auth/admin.directory.group: View and manage the provisioning of groups on your domain
            https://www.googleapis.com/auth/admin.directory.user.readonly: See info about users on your domain
            https://www.googleapis.com/auth/admin.directory.rolemanagement: Manage delegated admin roles for your domain
            https://www.googleapis.com/auth/admin.directory.user.security: Manage data access permissions for users on your
              domain
            https://www.googleapis.com/auth/admin.directory.customer: View and manage customer related information
            https://www.googleapis.com/auth/admin.directory.userschema.readonly: View user schemas on your domain
            https://www.googleapis.com/auth/admin.directory.device.mobile.action: Manage your mobile devices by performing
              administrative tasks
            https://www.googleapis.com/auth/admin.directory.orgunit: View and manage organization units on your domain
            https://www.googleapis.com/auth/admin.directory.group.member: View and manage group subscriptions on your domain
            https://www.googleapis.com/auth/admin.directory.device.chromeos: View and manage your ChromeOS devices' metadata
            https://www.googleapis.com/auth/admin.directory.device.mobile: View and manage your mobile devices' metadata
            https://www.googleapis.com/auth/cloud-platform: See, edit, configure, and delete your Google Cloud data and see
              the email address for your Google Account.
            https://www.googleapis.com/auth/admin.directory.group.member.readonly: View group subscriptions on your domain
            https://www.googleapis.com/auth/admin.directory.orgunit.readonly: View organization units on your domain
            https://www.googleapis.com/auth/admin.directory.user.alias: View and manage user aliases on your domain
            https://www.googleapis.com/auth/admin.directory.customer.readonly: View customer related information
            https://www.googleapis.com/auth/admin.directory.domain: View and manage the provisioning of domains for your customers
  schemas:
    DomainAlias:
      type: object
      properties:
        kind:
          description: Kind of resource this is.
          default: admin#directory#domainAlias
          type: string
        domainAliasName:
          description: The domain alias name.
          type: string
        verified:
          description: Indicates the verification state of a domain alias. (Read-only)
          type: boolean
        creationTime:
          description: The creation time of the domain alias. (Read-only).
          format: int64
          type: string
        parentDomainName:
          type: string
          description: The parent domain name that the domain alias is associated with. This can either be a primary or secondary
            domain name within a customer.
        etag:
          type: string
          description: ETag of the resource.
    Domains:
      type: object
      properties:
        etag:
          description: ETag of the resource.
          type: string
        creationTime:
          description: Creation time of the domain. Expressed in [Unix time](https://en.wikipedia.org/wiki/Epoch_time) format.
            (Read-only).
          type: string
          format: int64
        verified:
          description: Indicates the verification state of a domain. (Read-only).
          type: boolean
        isPrimary:
          type: boolean
          description: Indicates if the domain is a primary domain (Read-only).
        domainName:
          description: The domain name of the customer.
          type: string
        domainAliases:
          type: array
          description: A list of domain alias objects. (Read-only)
          items:
            $ref: '#/components/schemas/DomainAlias'
        kind:
          type: string
          description: Kind of resource this is.
          default: admin#directory#domain
    Domains2:
      properties:
        etag:
          description: ETag of the resource.
          type: string
        domains:
          items:
            $ref: '#/components/schemas/Domains'
          type: array
          description: A list of domain objects.
        kind:
          description: Kind of resource this is.
          type: string
          default: admin#directory#domains
      type: object
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
x-provenance:
  method: harvested
  publisher: Google
  source: https://admin.googleapis.com/$discovery/rest?version=directory_v1
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261109)