google_api_drive

# Copyright 2019 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# NOTE: This file is auto generated by the elixir code generator program.
# Do not edit this file manually.

defmodule GoogleApi.Drive.V3.Model.Permission do
  @moduledoc """
  A permission for a file. A permission grants a user, group, domain, or the world access to a file or a folder hierarchy. Some resource methods (such as `permissions.update`) require a `permissionId`. Use the `permissions.list` method to retrieve the ID for a file, folder, or shared drive.

  ## Attributes

  *   `allowFileDiscovery` (*type:* `boolean()`, *default:* `nil`) - Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type `domain` or `anyone`.
  *   `deleted` (*type:* `boolean()`, *default:* `nil`) - Output only. Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions.
  *   `displayName` (*type:* `String.t`, *default:* `nil`) - Output only. The "pretty" name of the value of the permission. The following is a list of examples for each type of permission: * `user` - User's full name, as defined for their Google account, such as "Joe Smith." * `group` - Name of the Google Group, such as "The Company Administrators." * `domain` - String domain name, such as "thecompany.com." * `anyone` - No `displayName` is present.
  *   `domain` (*type:* `String.t`, *default:* `nil`) - The domain to which this permission refers.
  *   `emailAddress` (*type:* `String.t`, *default:* `nil`) - The email address of the user or group to which this permission refers.
  *   `expirationTime` (*type:* `DateTime.t`, *default:* `nil`) - The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions: - They can only be set on user and group permissions - The time must be in the future - The time cannot be more than a year in the future
  *   `id` (*type:* `String.t`, *default:* `nil`) - Output only. The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as `permissionId`. IDs should be treated as opaque values.
  *   `kind` (*type:* `String.t`, *default:* `drive#permission`) - Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#permission"`.
  *   `pendingOwner` (*type:* `boolean()`, *default:* `nil`) - Whether the account associated with this permission is a pending owner. Only populated for `user` type permissions for files that are not in a shared drive.
  *   `permissionDetails` (*type:* `list(GoogleApi.Drive.V3.Model.PermissionPermissionDetails.t)`, *default:* `nil`) - Output only. Details of whether the permissions on this shared drive item are inherited or directly on this item. This is an output-only field which is present only for shared drive items.
  *   `photoLink` (*type:* `String.t`, *default:* `nil`) - Output only. A link to the user's profile photo, if available.
  *   `role` (*type:* `String.t`, *default:* `nil`) - The role granted by this permission. While new values may be supported in the future, the following are currently allowed: * `owner` * `organizer` * `fileOrganizer` * `writer` * `commenter` * `reader`
  *   `teamDrivePermissionDetails` (*type:* `list(GoogleApi.Drive.V3.Model.PermissionTeamDrivePermissionDetails.t)`, *default:* `nil`) - Output only. Deprecated: Output only. Use `permissionDetails` instead.
  *   `type` (*type:* `String.t`, *default:* `nil`) - The type of the grantee. Valid values are: * `user` * `group` * `domain` * `anyone` When creating a permission, if `type` is `user` or `group`, you must provide an `emailAddress` for the user or group. When `type` is `domain`, you must provide a `domain`. There isn't extra information required for an `anyone` type.
  *   `view` (*type:* `String.t`, *default:* `nil`) - Indicates the view for this permission. Only populated for permissions that belong to a view. 'published' is the only supported value.
  """

  use GoogleApi.Gax.ModelBase

  @type t :: %__MODULE__{
          :allowFileDiscovery => boolean() | nil,
          :deleted => boolean() | nil,
          :displayName => String.t() | nil,
          :domain => String.t() | nil,
          :emailAddress => String.t() | nil,
          :expirationTime => DateTime.t() | nil,
          :id => String.t() | nil,
          :kind => String.t() | nil,
          :pendingOwner => boolean() | nil,
          :permissionDetails =>
            list(GoogleApi.Drive.V3.Model.PermissionPermissionDetails.t()) | nil,
          :photoLink => String.t() | nil,
          :role => String.t() | nil,
          :teamDrivePermissionDetails =>
            list(GoogleApi.Drive.V3.Model.PermissionTeamDrivePermissionDetails.t()) | nil,
          :type => String.t() | nil,
          :view => String.t() | nil
        }

  field(:allowFileDiscovery)
  field(:deleted)
  field(:displayName)
  field(:domain)
  field(:emailAddress)
  field(:expirationTime, as: DateTime)
  field(:id)
  field(:kind)
  field(:pendingOwner)
  field(:permissionDetails, as: GoogleApi.Drive.V3.Model.PermissionPermissionDetails, type: :list)
  field(:photoLink)
  field(:role)

  field(:teamDrivePermissionDetails,
    as: GoogleApi.Drive.V3.Model.PermissionTeamDrivePermissionDetails,
    type: :list
  )

  field(:type)
  field(:view)
end

defimpl Poison.Decoder, for: GoogleApi.Drive.V3.Model.Permission do
  def decode(value, options) do
    GoogleApi.Drive.V3.Model.Permission.decode(value, options)
  end
end

defimpl Poison.Encoder, for: GoogleApi.Drive.V3.Model.Permission do
  def encode(value, options) do
    GoogleApi.Gax.ModelBase.encode(value, options)
  end
end