Google Marketing Platform Admin Members API

openapi: 3.2.0
info:
  title: Google Marketing Platform Admin API v1alpha Members API
  description: The Google Marketing Platform Admin API allows for programmatic access to the Google Marketing Platform configuration data. You can use the Google Marketing Platform Admin API to manage links between your Google Marketing Platform organization and Google Analytics accounts, and to set the service level of your GA4 properties.
  version: v1alpha
  contact:
    name: Google
    url: https://developers.google.com/analytics/devguides/config/gmp/v1
  license:
    name: Google APIs Terms of Service
    url: https://developers.google.com/terms
servers:
- url: https://marketingplatformadmin.googleapis.com
  description: Marketing Platform Admin API server
tags:
- name: Members
paths:
  /v1alpha/organizations/{organizationsId}/userGroups/{userGroupsId}/members:
    post:
      operationId: createUserGroupMember
      summary: marketingplatformadmin.organizations.userGroups.members.create
      description: Adds a member to the specified GMP user group.
      tags:
      - Members
      parameters:
      - name: organizationsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+parent}/members`.
      - name: userGroupsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+parent}/members`.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserGroupMember'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/marketingplatformadmin.analytics.update
      x-discovery-id: marketingplatformadmin.organizations.userGroups.members.create
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserGroupMember'
    get:
      operationId: listUserGroupMembers
      summary: marketingplatformadmin.organizations.userGroups.members.list
      description: Returns a list of members in the specified user group.
      tags:
      - Members
      parameters:
      - name: organizationsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+parent}/members`.
      - name: userGroupsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+parent}/members`.
      - name: pageToken
        in: query
        required: false
        description: Optional. A page token, received from a previous ListUserGroupMembers call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserGroupMembers` must match the call that provided the page token.
        schema:
          type: string
      - name: pageSize
        in: query
        required: false
        description: Optional. The maximum number of user group members to return in one call. The service may return fewer than this value. If unspecified, at most 50 user group members will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUserGroupMembersResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/marketingplatformadmin.analytics.read
        - https://www.googleapis.com/auth/marketingplatformadmin.analytics.update
      x-discovery-id: marketingplatformadmin.organizations.userGroups.members.list
  /v1alpha/organizations/{organizationsId}/userGroups/{userGroupsId}/members/{membersId}:
    delete:
      operationId: deleteUserGroupMember
      summary: marketingplatformadmin.organizations.userGroups.members.delete
      description: Deletes a member in the specified GMP user group.
      tags:
      - Members
      parameters:
      - name: organizationsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+name}`.
      - name: userGroupsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+name}`.
      - name: membersId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+name}`.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Empty'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/marketingplatformadmin.analytics.update
      x-discovery-id: marketingplatformadmin.organizations.userGroups.members.delete
    get:
      operationId: getUserGroupMember
      summary: marketingplatformadmin.organizations.userGroups.members.get
      description: Looks up a single user group member.
      tags:
      - Members
      parameters:
      - name: organizationsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+name}`.
      - name: userGroupsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+name}`.
      - name: membersId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+name}`.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserGroupMember'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/marketingplatformadmin.analytics.read
        - https://www.googleapis.com/auth/marketingplatformadmin.analytics.update
      x-discovery-id: marketingplatformadmin.organizations.userGroups.members.get
    patch:
      operationId: patchUserGroupMember
      summary: marketingplatformadmin.organizations.userGroups.members.patch
      description: Updates a member in the specified GMP user group.
      tags:
      - Members
      parameters:
      - name: organizationsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+name}`.
      - name: userGroupsId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+name}`.
      - name: membersId
        in: path
        required: true
        schema:
          type: string
        description: Path segment of `v1alpha/{+name}`.
      - name: updateMask
        in: query
        required: false
        description: Required. The list of fields to update. Field names must be in snake case (for example, "field_to_update"). Omitted fields will not be updated. To replace the entire entity, use one path with the string "*" to match all fields.
        schema:
          type: string
          format: google-fieldmask
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserGroupMember'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/marketingplatformadmin.analytics.update
      x-discovery-id: marketingplatformadmin.organizations.userGroups.members.patch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserGroupMember'
components:
  schemas:
    Empty:
      type: object
      description: 'A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }'
      properties: {}
    ListUserGroupMembersResponse:
      type: object
      description: Response message for ListUserGroupMembers RPC.
      properties:
        userGroupMembers:
          type: array
          description: User group members in the user group.
          items:
            $ref: '#/components/schemas/UserGroupMember'
        nextPageToken:
          type: string
          description: A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
    UserGroupMember:
      type: object
      description: A resource message representing a member of a user group.
      properties:
        userEmail:
          type: string
          description: Email address of the user member.
        userGroup:
          type: string
          description: User group resource name of the group member.
        name:
          type: string
          description: 'Identifier. The resource name of this UserGroupMember. Format: organizations/{org_id}/userGroups/{user_group_id}/members/{member_id} Example: "organizations/123abc/userGroups/456def/members/789ghi"'
        membershipRole:
          type: string
          description: Optional. The role of the member in the user group.
          enum:
          - MEMBERSHIP_ROLE_UNSPECIFIED
          - MEMBERSHIP_ROLE_OWNER
          - MEMBERSHIP_ROLE_MEMBER
          x-enum-descriptions:
          - Unspecified membership role.
          - Owner role that can add and remove group members.
          - Member role that receives all permissions assigned to the group.
  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/marketingplatformadmin.analytics.update: Manage your Google Analytics product account data in GMP home
            https://www.googleapis.com/auth/marketingplatformadmin.analytics.read: View your Google Analytics product account data in GMP home
x-generated-from: google-discovery-document
x-source: https://marketingplatformadmin.googleapis.com/$discovery/rest?version=v1alpha
x-discovery-revision: '20261103'