Class: Google::Apis::GmailV1::Label

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
lib/google/apis/gmail_v1/classes.rb,
lib/google/apis/gmail_v1/representations.rb,
lib/google/apis/gmail_v1/representations.rb

Overview

Labels are used to categorize messages and threads within the user's mailbox. The maximum number of labels supported for a user's mailbox is 10,000.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ Label

Returns a new instance of Label.



758
759
760
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 758

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#color ⇒ Google::Apis::GmailV1::LabelColor

The color to assign to the label. Color is only available for labels that have their type set to user. Corresponds to the JSON property color

Returns:



703
704
705
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 703

def color
  @color
end

#id ⇒ String

The immutable ID of the label. Corresponds to the JSON property id

Returns:

  • (String) 


708
709
710
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 708

def id
  @id
end

#label_list_visibility ⇒ String

The visibility of the label in the label list in the Gmail web interface. Corresponds to the JSON property labelListVisibility

Returns:

  • (String) 


713
714
715
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 713

def label_list_visibility
  @label_list_visibility
end

#message_list_visibility ⇒ String

The visibility of messages with this label in the message list in the Gmail web interface. Corresponds to the JSON property messageListVisibility

Returns:

  • (String) 


719
720
721
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 719

def message_list_visibility
  @message_list_visibility
end

#messages_total ⇒ Fixnum

The total number of messages with the label. Corresponds to the JSON property messagesTotal

Returns:

  • (Fixnum) 


724
725
726
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 724

def messages_total
  @messages_total
end

#messages_unread ⇒ Fixnum

The number of unread messages with the label. Corresponds to the JSON property messagesUnread

Returns:

  • (Fixnum) 


729
730
731
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 729

def messages_unread
  @messages_unread
end

#name ⇒ String

The display name of the label. Corresponds to the JSON property name

Returns:

  • (String) 


734
735
736
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 734

def name
  @name
end

#threads_total ⇒ Fixnum

The total number of threads with the label. Corresponds to the JSON property threadsTotal

Returns:

  • (Fixnum) 


739
740
741
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 739

def threads_total
  @threads_total
end

#threads_unread ⇒ Fixnum

The number of unread threads with the label. Corresponds to the JSON property threadsUnread

Returns:

  • (Fixnum) 


744
745
746
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 744

def threads_unread
  @threads_unread
end

#type ⇒ String

The owner type for the label. User labels are created by the user and can be modified and deleted by the user and can be applied to any message or thread. System labels are internally created and cannot be added, modified, or deleted. System labels may be able to be applied to or removed from messages and threads under some circumstances but this is not guaranteed. For example, users can apply and remove the INBOX and UNREAD labels from messages and threads, but cannot apply or remove the DRAFTS or SENT labels from messages or threads. Corresponds to the JSON property type

Returns:

  • (String) 


756
757
758
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 756

def type
  @type
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



763
764
765
766
767
768
769
770
771
772
773
774
 
# File 'lib/google/apis/gmail_v1/classes.rb', line 763

def update!(**args)
  @color = args[:color] if args.key?(:color)
  @id = args[:id] if args.key?(:id)
  @label_list_visibility = args[:label_list_visibility] if args.key?(:label_list_visibility)
  @message_list_visibility = args[:message_list_visibility] if args.key?(:message_list_visibility)
  @messages_total = args[:messages_total] if args.key?(:messages_total)
  @messages_unread = args[:messages_unread] if args.key?(:messages_unread)
  @name = args[:name] if args.key?(:name)
  @threads_total = args[:threads_total] if args.key?(:threads_total)
  @threads_unread = args[:threads_unread] if args.key?(:threads_unread)
  @type = args[:type] if args.key?(:type)
end