Youtube I18n API

openapi: 3.2.0
info:
  title: YouTube Data API v3 I18n API
  description: The YouTube Data API v3 provides access to YouTube data including videos, channels, playlists, comments, subscriptions, captions, and other YouTube resources. It allows applications to search for content and manage YouTube accounts programmatically.
  version: v3
  contact:
    name: YouTube API Support
    url: https://developers.google.com/youtube/v3/support
  termsOfService: https://developers.google.com/youtube/terms/api-services-terms-of-service
servers:
- url: https://www.googleapis.com/youtube/v3
  description: YouTube Data API v3 base server
security:
- oauth2:
  - https://www.googleapis.com/auth/youtube
- apiKey: []
tags:
- name: I18n
  description: Operations related to internationalization resources
paths:
  /i18nLanguages:
    get:
      operationId: youtube.i18nLanguages.list
      summary: Youtube List I18n Languages
      description: Returns a list of application languages that the YouTube website supports. The list includes both the language code and the human-readable name of each supported language.
      tags:
      - I18n
      parameters:
      - $ref: '#/components/parameters/part'
      - name: hl
        in: query
        description: Specifies the language that should be used for text values in the API response.
        schema:
          type: string
        example: example_value
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/key'
      responses:
        '200':
          description: Successful response containing a list of i18n language resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/I18nLanguageListResponse'
              examples:
                YoutubeI18nlanguagesList200Example:
                  summary: Default youtube.i18nLanguages.list 200 response
                  x-microcks-default: true
                  value:
                    kind: youtube#video
                    etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                    items:
                    - kind: youtube#video
                      etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                      id: abc123def456
                      snippet:
                        hl: example_value
                        name: Example Title
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /i18nRegions:
    get:
      operationId: youtube.i18nRegions.list
      summary: Youtube List I18n Regions
      description: Returns a list of content regions that the YouTube website supports. The list includes region codes and human-readable names used for region-specific content filtering.
      tags:
      - I18n
      parameters:
      - $ref: '#/components/parameters/part'
      - name: hl
        in: query
        description: Specifies the language that should be used for text values in the API response.
        schema:
          type: string
        example: example_value
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/key'
      responses:
        '200':
          description: Successful response containing a list of i18n region resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/I18nRegionListResponse'
              examples:
                YoutubeI18nregionsList200Example:
                  summary: Default youtube.i18nRegions.list 200 response
                  x-microcks-default: true
                  value:
                    kind: youtube#video
                    etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                    items:
                    - kind: youtube#video
                      etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                      id: abc123def456
                      snippet:
                        gl: example_value
                        name: Example Title
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  responses:
    BadRequest:
      description: The request was invalid or malformed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: The request was authenticated but the caller does not have permission to perform the requested operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ErrorResponse:
      type: object
      description: A standard error response returned by the YouTube Data API.
      properties:
        error:
          type: object
          description: The error details.
          properties:
            code:
              type: integer
              description: The HTTP status code of the error.
            message:
              type: string
              description: A human-readable description of the error.
            errors:
              type: array
              description: A list of individual errors.
              items:
                type: object
                properties:
                  message:
                    type: string
                    description: A human-readable description of the error.
                  domain:
                    type: string
                    description: The domain in which the error occurred.
                  reason:
                    type: string
                    description: The reason for the error.
          example: example_value
    I18nRegionListResponse:
      type: object
      description: A list of i18n region resources supported by the YouTube website.
      properties:
        kind:
          type: string
          description: Identifies the API resource's type. Value is youtube#i18nRegionListResponse.
          default: youtube#i18nRegionListResponse
          example: youtube#video
        etag:
          type: string
          description: The Etag of this resource.
          example: XI7nbFXulYBIpL0ayR_gDh3eu1k
        items:
          type: array
          description: A list of regions where YouTube is available.
          items:
            type: object
            properties:
              kind:
                type: string
                description: Identifies the API resource's type. Value is youtube#i18nRegion.
              etag:
                type: string
                description: The Etag of this resource.
              id:
                type: string
                description: The ID uniquely identifying the i18n region.
              snippet:
                type: object
                description: The snippet object contains basic details about the i18n region.
                properties:
                  gl:
                    type: string
                    description: The region code as a 2-letter ISO country code.
                  name:
                    type: string
                    description: The name of the region.
          example: []
    I18nLanguageListResponse:
      type: object
      description: A list of i18n language resources supported by the YouTube website.
      properties:
        kind:
          type: string
          description: Identifies the API resource's type. Value is youtube#i18nLanguageListResponse.
          default: youtube#i18nLanguageListResponse
          example: youtube#video
        etag:
          type: string
          description: The Etag of this resource.
          example: XI7nbFXulYBIpL0ayR_gDh3eu1k
        items:
          type: array
          description: A list of supported i18n languages.
          items:
            type: object
            properties:
              kind:
                type: string
                description: Identifies the API resource's type. Value is youtube#i18nLanguage.
              etag:
                type: string
                description: The Etag of this resource.
              id:
                type: string
                description: The ID uniquely identifying the i18n language.
              snippet:
                type: object
                description: The snippet object contains basic details about the i18n language.
                properties:
                  hl:
                    type: string
                    description: A BCP-47 code that uniquely identifies a language.
                  name:
                    type: string
                    description: The name of the language as it is written in the language itself.
          example: []
  parameters:
    fields:
      name: fields
      in: query
      description: Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need.
      schema:
        type: string
    key:
      name: key
      in: 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.
      schema:
        type: string
    part:
      name: part
      in: query
      required: true
      description: Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property.
      schema:
        type: string
  securitySchemes:
    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/youtube: Manage your YouTube account
            https://www.googleapis.com/auth/youtube.readonly: View your YouTube account
            https://www.googleapis.com/auth/youtube.upload: Manage your YouTube videos
            https://www.googleapis.com/auth/youtube.force-ssl: See, edit, and permanently delete your YouTube videos, ratings, comments and captions
            https://www.googleapis.com/auth/youtubepartner: View and manage your assets and associated content on YouTube
    apiKey:
      type: apiKey
      in: query
      name: key