yt 0.25.13 → 0.32.2

data/lib/yt/collections/group_items.rb

@@ -0,0 +1,45 @@
+require 'yt/collections/base'
+require 'yt/models/group_item'
+
+module Yt
+  module Collections
+    # @private
+    class GroupItems < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        super(data).tap do |attributes|
+          attributes[:video] = data['video']
+        end
+      end
+
+      def list_params
+        super.tap do |params|
+          params[:host] = 'youtubeanalytics.googleapis.com'
+          params[:path] = "/v2/groupItems"
+          params[:params] = {group_id: @parent.id}
+          if @auth.owner_name
+            params[:params][:on_behalf_of_content_owner] = @auth.owner_name
+          end
+        end
+      end
+
+      def eager_load_items_from(items)
+        if included_relationships.include?(:video)
+          all_video_ids = items.map{|item| item['resource']['id']}.uniq
+          all_video_ids.each_slice(50) do |video_ids|
+            conditions = {id: video_ids.join(',')}
+            conditions[:part] = 'snippet,status,statistics,contentDetails'
+            videos = Collections::Videos.new(auth: @auth).where conditions
+            items.each do |item|
+              video = videos.find{|v| v.id == item['resource']['id']}
+              item['video'] = video if video
+            end
+          end
+        end
+        super
+      end
+    end
+  end
+end

data/lib/yt/collections/reports.rb

@@ -11,12 +11,15 @@ module Yt
         hash[:traffic_source] = {name: 'insightTrafficSourceType', parse: ->(source, *values) { @metrics.keys.zip(values.map{|v| {TRAFFIC_SOURCES.key(source) => v}}).to_h} }
         hash[:playback_location] = {name: 'insightPlaybackLocationType', parse: ->(location, *values) { @metrics.keys.zip(values.map{|v| {PLAYBACK_LOCATIONS.key(location) => v}}).to_h} }
         hash[:embedded_player_location] = {name: 'insightPlaybackLocationDetail', parse: ->(url, *values) {@metrics.keys.zip(values.map{|v| {url => v}}).to_h} }
+        hash[:subscribed_status] = {name: 'subscribedStatus', parse: ->(status, *values) {@metrics.keys.zip(values.map{|v| {SUBSCRIBED_STATUSES.key(status) => v}}).to_h} }
         hash[:related_video] = {name: 'insightTrafficSourceDetail', parse: ->(video_id, *values) { @metrics.keys.zip(values.map{|v| {video_id => v}}).to_h} }
         hash[:search_term] = {name: 'insightTrafficSourceDetail', parse: ->(search_term, *values) {@metrics.keys.zip(values.map{|v| {search_term => v}}).to_h} }
         hash[:referrer] = {name: 'insightTrafficSourceDetail', parse: ->(url, *values) {@metrics.keys.zip(values.map{|v| {url => v}}).to_h} }
         hash[:video] = {name: 'video', parse: ->(video_id, *values) { @metrics.keys.zip(values.map{|v| {video_id => v}}).to_h} }
         hash[:playlist] = {name: 'playlist', parse: ->(playlist_id, *values) { @metrics.keys.zip(values.map{|v| {playlist_id => v}}).to_h} }
-        hash[:device_type] = {name: 'deviceType', parse: ->(type, *values) {@metrics.keys.zip(values.map{|v| {type.downcase.to_sym => v}}).to_h} }
+        hash[:device_type] = {name: 'deviceType', parse: ->(type, *values) {@metrics.keys.zip(values.map{|v| {DEVICE_TYPES.key(type) => v}}).to_h} }
+        hash[:operating_system] = {name: 'operatingSystem', parse: ->(os, *values) {@metrics.keys.zip(values.map{|v| {OPERATING_SYSTEMS.key(os) => v}}).to_h} }
+        hash[:youtube_product] = {name: 'youtubeProduct', parse: ->(product, *values) {@metrics.keys.zip(values.map{|v| {YOUTUBE_PRODUCTS.key(product) => v}}).to_h} }
         hash[:country] = {name: 'country', parse: ->(country_code, *values) { @metrics.keys.zip(values.map{|v| {country_code => v}}).to_h} }
         hash[:state] = {name: 'province', parse: ->(country_and_state_code, *values) { @metrics.keys.zip(values.map{|v| {country_and_state_code[3..-1] => v}}).to_h} }
         hash[:gender_age_group] = {name: 'gender,ageGroup', parse: ->(gender, *values) { [gender.downcase.to_sym, *values] }}
@@ -43,6 +46,8 @@ module Yt
         google: 'GOOGLE_SEARCH',
         notification: 'NOTIFICATION',
         playlist_page: 'YT_PLAYLIST_PAGE',
+        campaign_card: 'CAMPAIGN_CARD',
+        end_screen: 'END_SCREEN',
         info_card: 'INFO_CARD'
       }
 
@@ -53,17 +58,72 @@ module Yt
         embedded: 'EMBEDDED',
         other: 'YT_OTHER',
         external_app: 'EXTERNAL_APP',
+        search: 'SEARCH', # undocumented but returned by the API
+        browse: 'BROWSE', # undocumented but returned by the API
         mobile: 'MOBILE' # only present for data < September 10, 2013
       }
 
+      # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Playback_Detail_Dimensions
+      SUBSCRIBED_STATUSES = {
+        subscribed: 'SUBSCRIBED',
+        unsubscribed: 'UNSUBSCRIBED'
+      }
+
+      # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct
+      YOUTUBE_PRODUCTS = {
+        core: 'CORE',
+        gaming: 'GAMING',
+        kids: 'KIDS',
+        unknown: 'UNKNOWN'
+      }
+
+      # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Device_Dimensions
+      DEVICE_TYPES = {
+        desktop: 'DESKTOP',
+        game_console: 'GAME_CONSOLE',
+        mobile: 'MOBILE',
+        tablet: 'TABLET',
+        tv: 'TV',
+        unknown_platform: 'UNKNOWN_PLATFORM'
+      }
+
+      # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Device_Dimensions
+      OPERATING_SYSTEMS = {
+        android: 'ANDROID',
+        bada: 'BADA',
+        blackberry: 'BLACKBERRY',
+        chromecast: 'CHROMECAST',
+        docomo: 'DOCOMO',
+        firefox: 'FIREFOX',
+        hiptop: 'HIPTOP',
+        ios: 'IOS',
+        linux: 'LINUX',
+        macintosh: 'MACINTOSH',
+        meego: 'MEEGO',
+        nintendo_3ds: 'NINTENDO_3DS',
+        other: 'OTHER',
+        playstation: 'PLAYSTATION',
+        playstation_vita: 'PLAYSTATION_VITA',
+        realmedia: 'REALMEDIA',
+        smart_tv: 'SMART_TV',
+        symbian: 'SYMBIAN',
+        tizen: 'TIZEN',
+        webos: 'WEBOS',
+        wii: 'WII',
+        windows: 'WINDOWS',
+        windows_mobile: 'WINDOWS_MOBILE',
+        xbox: 'XBOX'
+      }
+
       attr_writer :metrics
 
-      def within(days_range, country, state, dimension, videos, try_again = true)
+      def within(days_range, country, state, dimension, videos, historical, max_retries = 3)
         @days_range = days_range
-        @dimension = dimension
         @country = country
         @state = state
+        @dimension = dimension
         @videos = videos
+        @historical = historical
         if dimension == :gender_age_group # array of array
           Hash.new{|h,k| h[k] = Hash.new 0.0}.tap do |hash|
             each{|gender, age_group, value| hash[gender][age_group[3..-1]] = value}
@@ -86,10 +146,10 @@ module Yt
             end
           elsif dimension == :day
             hash = hash.transform_values{|h| h.sort_by{|day, v| day}.to_h}
-          elsif dimension.in? [:traffic_source, :country, :state, :playback_location, :device_type]
+          elsif dimension.in? [:traffic_source, :country, :state, :playback_location, :device_type, :operating_system, :subscribed_status]
             hash = hash.transform_values{|h| h.sort_by{|range, v| -v}.to_h}
           end
-          (@metrics.one? || @metrics.keys == [:earnings, :estimated_minutes_watched]) ? hash[@metrics.keys.first] : hash
+          (@metrics.one? || @metrics.keys == [:estimated_revenue, :estimated_minutes_watched]) ? hash[@metrics.keys.first] : hash
         end
       # NOTE: Once in a while, YouTube responds with 400 Error and the message
       # "Invalid query. Query did not conform to the expectations."; in this
@@ -98,7 +158,7 @@ module Yt
       # same query is a workaround that works and can hardly cause any damage.
       # Similarly, once in while YouTube responds with a random 503 error.
       rescue Yt::Error => e
-        try_again && rescue?(e) ? sleep(3) && within(days_range, country, state, dimension, videos, false) : raise
+        (max_retries > 0) && rescue?(e) ? sleep(3) && within(days_range, country, state, dimension, videos, historical, max_retries - 1) : raise
       end
 
     private
@@ -117,7 +177,8 @@ module Yt
       # @see https://developers.google.com/youtube/analytics/v1/content_owner_reports
       def list_params
         super.tap do |params|
-          params[:path] = '/youtube/analytics/v1/reports'
+          params[:host] = 'youtubeanalytics.googleapis.com'
+          params[:path] = '/v2/reports'
           params[:params] = reports_params
           params[:camelize_params] = false
         end
@@ -125,15 +186,16 @@ module Yt
 
       def reports_params
         @parent.reports_params.tap do |params|
-          params['start-date'] = @days_range.begin
-          params['end-date'] = @days_range.end
+          params['startDate'] = @days_range.begin
+          params['endDate'] = @days_range.end
           params['metrics'] = @metrics.keys.join(',').to_s.camelize(:lower)
           params['dimensions'] = DIMENSIONS[@dimension][:name] unless @dimension == :range
-          params['max-results'] = 50 if @dimension.in? [:playlist, :video]
-          params['max-results'] = 25 if @dimension.in? [:embedded_player_location, :related_video, :search_term, :referrer]
+          params['includeHistoricalChannelData'] = @historical if @historical
+          params['maxResults'] = 50 if @dimension.in? [:playlist, :video]
+          params['maxResults'] = 25 if @dimension.in? [:embedded_player_location, :related_video, :search_term, :referrer]
           if @dimension.in? [:video, :playlist, :embedded_player_location, :related_video, :search_term, :referrer]
-            if @metrics.keys == [:earnings, :estimated_minutes_watched]
-              params['sort'] = '-earnings'
+            if @metrics.keys == [:estimated_revenue, :estimated_minutes_watched]
+              params['sort'] = '-estimatedRevenue'
             else
               params['sort'] = "-#{@metrics.keys.join(',').to_s.camelize(:lower)}"
             end

data/lib/yt/collections/revocations.rb

@@ -0,0 +1,30 @@
+require 'yt/collections/authentications'
+require 'yt/models/revocation'
+
+module Yt
+  module Collections
+    class Revocations < Authentications
+      attr_accessor :auth_params
+
+    private
+
+      # This overrides the parent mehthod defined in Authentications
+      def attributes_for_new_item(data)
+        {data: data}
+      end
+
+      def list_params
+        super.tap do |params|
+          params[:host] = 'accounts.google.com'
+          params[:path] = '/o/oauth2/revoke'
+          params[:request_format] = nil
+          params[:method] = :get
+          params[:auth] = nil
+          params[:body] = nil
+          params[:camelize_body] = false
+          params[:params] = auth_params
+        end
+      end
+    end
+  end
+end

data/lib/yt/collections/video_groups.rb

@@ -0,0 +1,29 @@
+require 'yt/collections/base'
+require 'yt/models/video_group'
+require 'yt/models/group_info'
+
+module Yt
+  module Collections
+    # @private
+    class VideoGroups < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        {id: data['id'], auth: @auth, group_info: Yt::GroupInfo.new(data: data)}
+      end
+
+      def new_item(data)
+        super if data['contentDetails']['itemType'] == 'youtube#video'
+      end
+
+      def list_params
+        super.tap do |params|
+          params[:host] = 'youtubeanalytics.googleapis.com'
+          params[:path] = "/v2/groups"
+          params[:params] = @parent.video_groups_params
+        end
+      end
+    end
+  end
+end

data/lib/yt/collections/videos.rb

@@ -10,6 +10,7 @@ module Yt
     class Videos < Base
       def where(requirements = {})
         @published_before = nil
+        @halt_list = false
         super
       end
 
@@ -25,18 +26,23 @@ module Yt
           attributes[:content_details] = data['contentDetails']
           attributes[:statistics] = data['statistics']
           attributes[:video_category] = data['videoCategory']
+          attributes[:claim] = data['claim']
           attributes[:auth] = @auth
         end
       end
 
       def eager_load_items_from(items)
         if included_relationships.any?
-          include_category = included_relationships.delete(:category)
-          included_relationships.append(:snippet).uniq! if include_category
+          associations = [:claim, :category]
+          if (included_relationships & associations).any?
+            included_relationships.append(:snippet).uniq!
+          end
 
           ids = items.map{|item| item['id']['videoId']}
-          parts = included_relationships.map{|r| r.to_s.camelize(:lower)}
-          conditions = {id: ids.join(','), part: parts.join(',')}
+          parts = (included_relationships - associations).map do |r|
+            r.to_s.camelize(:lower)
+          end
+          conditions = { id: ids.join(','), part: parts.join(',') }
           videos = Collections::Videos.new(auth: @auth).where conditions
 
           items.each do |item|
@@ -51,7 +57,20 @@ module Yt
             end if video
           end
 
-          if include_category
+          if included_relationships.include? :claim
+            video_ids = items.map{|item| item['id']['videoId']}.uniq
+            conditions = {
+              video_id: video_ids.join(','),
+              include_third_party_claims: false
+            }
+            claims = @parent.claims.includes(:asset).where conditions
+            items.each do |item|
+              claim = claims.find { |c| c.video_id == item['id']['videoId']}
+              item['claim'] = claim
+            end
+          end
+
+          if included_relationships.include? :category
             category_ids = items.map{|item| item['snippet']['categoryId']}.uniq
             conditions = {id: category_ids.join(',')}
             video_categories = Collections::VideoCategories.new(auth: @auth).where conditions
@@ -77,7 +96,7 @@ module Yt
       def next_page
         super.tap do |items|
           halt_list if use_list_endpoint? && items.empty? && @page_token.nil?
-          add_offset_to(items) if !use_list_endpoint? && @page_token.nil? && videos_params[:order] == 'date'
+          add_offset_to(items) if !use_list_endpoint? && videos_params[:order] == 'date' && !(videos_params[:for_mine] || videos_params[:for_content_owner])
         end
       end
 
@@ -86,9 +105,15 @@ module Yt
       # that limit, the query is restarted with a publishedBefore filter in
       # case there are more videos to be listed for a channel
       def add_offset_to(items)
-        if items.count == videos_params[:max_results]
+        @fetched_items ||= 0
+        if (@fetched_items += items.count) >= 500
           last_published = items.last['snippet']['publishedAt']
-          @page_token, @published_before = '', last_published
+          last_published = DateTime.rfc3339(last_published) - 1.second
+          last_published = last_published.strftime '%FT%T.999Z'
+          @page_token, @published_before, @fetched_items = '', last_published, 0
+        elsif (1...50) === @last_index % 50
+          @halt_list, @page_token = true, nil
+          @last_index += items.size
         end
       end
 
@@ -134,4 +159,4 @@ module Yt
       end
     end
   end
-end
+end

data/lib/yt/constants/geography.rb

@@ -0,0 +1,326 @@
+require 'active_support'
+require 'active_support/core_ext/hash/indifferent_access'
+
+module Yt
+  # The list of country codes and names used by the YouTube Analytics API.
+  # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country
+  COUNTRIES = {
+    AC: 'Ascension',
+    AD: 'Andorra',
+    AE: 'United Arab Emirates',
+    AF: 'Afghanistan',
+    AG: 'Antigua and Barbuda',
+    AI: 'Anguilla',
+    AL: 'Albania',
+    AM: 'Armenia',
+    AN: 'Netherlands Antilles',
+    AO: 'Angola',
+    AQ: 'Antarctic Territory',
+    AR: 'Argentina',
+    AS: 'American Samoa',
+    AT: 'Austria',
+    AU: 'Australia',
+    AW: 'Aruba',
+    AX: 'Aland',
+    AZ: 'Azerbaijan',
+    BA: 'Bosnia and Herzegovina',
+    BB: 'Barbados',
+    BD: 'Bangladesh',
+    BE: 'Belgium',
+    BF: 'Burkina Faso',
+    BG: 'Bulgaria',
+    BH: 'Bahrain',
+    BI: 'Burundi',
+    BJ: 'Benin',
+    BL: 'Saint Barthélemy',
+    BM: 'Bermuda',
+    BN: 'Brunei',
+    BO: 'Bolivia',
+    BQ: 'Bonaire, Sint Eustatius and Saba',
+    BR: 'Brazil',
+    BS: 'Bahamas',
+    BT: 'Bhutan',
+    BV: 'Bouvet Island',
+    BW: 'Botswana',
+    BY: 'Belarus',
+    BZ: 'Belize',
+    CA: 'Canada',
+    CC: 'Cocos (Keeling) Islands',
+    CD: 'Congo',
+    CF: 'Central African Republic',
+    CG: 'Congo',
+    CH: 'Switzerland',
+    CI: 'Ivory Coast',
+    CK: 'Cook Islands',
+    CL: 'Chile',
+    CM: 'Cameroon',
+    CN: 'China',
+    CO: 'Colombia',
+    CR: 'Costa Rica',
+    CU: 'Cuba',
+    CV: 'Cape Verde',
+    CW: 'Curaçao',
+    CX: 'Christmas Island',
+    CY: 'Cyprus',
+    CZ: 'Czech Republic',
+    DE: 'Germany',
+    DJ: 'Djibouti',
+    DK: 'Denmark',
+    DM: 'Dominica',
+    DO: 'Dominican Republic',
+    DZ: 'Algeria',
+    EC: 'Ecuador',
+    EE: 'Estonia',
+    EG: 'Egypt',
+    EH: 'Western Sahara',
+    ER: 'Eritrea',
+    ES: 'Spain',
+    ET: 'Ethiopia',
+    FI: 'Finland',
+    FJ: 'Fiji',
+    FK: 'Falkland Islands',
+    FM: 'Micronesia',
+    FO: 'Faroe Islands',
+    FR: 'France',
+    GA: 'Gabon',
+    GB: 'United Kingdom',
+    GD: 'Grenada',
+    GE: 'Georgia',
+    GF: 'French Guiana',
+    GG: 'Guernsey',
+    GH: 'Ghana',
+    GI: 'Gibraltar',
+    GL: 'Greenland',
+    GM: 'Gambia',
+    GN: 'Guinea',
+    GP: 'Guadeloupe',
+    GQ: 'Equatorial Guinea',
+    GR: 'Greece',
+    GS: 'South Georgia & South Sandwich Islands',
+    GT: 'Guatemala',
+    GU: 'Guam',
+    GW: 'Guinea-Bissau',
+    GY: 'Guyana',
+    HK: 'Hong Kong',
+    HM: 'Heard Island and McDonald Islands',
+    HN: 'Honduras',
+    HR: 'Croatia',
+    HT: 'Haiti',
+    HU: 'Hungary',
+    ID: 'Indonesia',
+    IE: 'Ireland',
+    IL: 'Israel',
+    IM: 'Isle of Man',
+    IN: 'India',
+    IO: 'British Indian Ocean Territory',
+    IQ: 'Iraq',
+    IR: 'Iran',
+    IS: 'Iceland',
+    IT: 'Italy',
+    JE: 'Jersey',
+    JM: 'Jamaica',
+    JO: 'Jordan',
+    JP: 'Japan',
+    KE: 'Kenya',
+    KG: 'Kyrgyzstan',
+    KH: 'Cambodia',
+    KI: 'Kiribati',
+    KM: 'Comoros',
+    KN: 'Saint Kitts and Nevis',
+    KP: 'North Korea',
+    KR: 'South Korea',
+    KW: 'Kuwait',
+    KY: 'Cayman Islands',
+    KZ: 'Kazakhstan',
+    LA: 'Laos',
+    LB: 'Lebanon',
+    LC: 'Saint Lucia',
+    LI: 'Liechtenstein',
+    LK: 'Sri Lanka',
+    LR: 'Liberia',
+    LS: 'Lesotho',
+    LT: 'Lithuania',
+    LU: 'Luxembourg',
+    LV: 'Latvia',
+    LY: 'Libya',
+    MA: 'Morocco',
+    MC: 'Monaco',
+    MD: 'Moldova',
+    ME: 'Montenegro',
+    MF: 'Saint Martin',
+    MG: 'Madagascar',
+    MH: 'Marshall Islands',
+    MK: 'Macedonia',
+    ML: 'Mali',
+    MM: 'Myanmar',
+    MN: 'Mongolia',
+    MO: 'Macau',
+    MP: 'Northern Mariana Islands',
+    MQ: 'Martinique',
+    MR: 'Mauritania',
+    MS: 'Montserrat',
+    MT: 'Malta',
+    MU: 'Mauritius',
+    MV: 'Maldives',
+    MW: 'Malawi',
+    MX: 'Mexico',
+    MY: 'Malaysia',
+    MZ: 'Mozambique',
+    NA: 'Namibia',
+    NC: 'New Caledonia',
+    NE: 'Niger',
+    NF: 'Norfolk Island',
+    NG: 'Nigeria',
+    NI: 'Nicaragua',
+    NL: 'Netherlands',
+    NO: 'Norway',
+    NP: 'Nepal',
+    NR: 'Nauru',
+    NU: 'Niue',
+    NZ: 'New Zealand',
+    OM: 'Oman',
+    PA: 'Panama',
+    PE: 'Peru',
+    PF: 'French Polynesia',
+    PG: 'Papua New Guinea',
+    PH: 'Philippines',
+    PK: 'Pakistan',
+    PL: 'Poland',
+    PM: 'Saint Pierre and Miquelon',
+    PN: 'Pitcairn Islands',
+    PR: 'Puerto Rico',
+    PS: 'Palestinian Territory',
+    PT: 'Portugal',
+    PW: 'Palau',
+    PY: 'Paraguay',
+    QA: 'Qatar',
+    RE: 'Reunion',
+    RO: 'Romania',
+    RS: 'Serbia',
+    RU: 'Russia',
+    RW: 'Rwanda',
+    SA: 'Saudi Arabia',
+    SB: 'Solomon Islands',
+    SC: 'Seychelles',
+    SD: 'Sudan',
+    SE: 'Sweden',
+    SG: 'Singapore',
+    SH: 'Saint Helena',
+    SI: 'Slovenia',
+    SJ: 'Svalbard',
+    SK: 'Slovakia',
+    SL: 'Sierra Leone',
+    SM: 'San Marino',
+    SN: 'Senegal',
+    SO: 'Somalia',
+    SR: 'Suriname',
+    SS: 'South Sudan',
+    ST: 'Sao Tome and Principe',
+    SV: 'El Salvador',
+    SX: 'Sint Maarten',
+    SY: 'Syria',
+    SZ: 'Swaziland',
+    TA: 'Tristan da Cunha',
+    TC: 'Turks and Caicos Islands',
+    TD: 'Chad',
+    TF: 'French Southern and Antarctic Lands',
+    TG: 'Togo',
+    TH: 'Thailand',
+    TJ: 'Tajikistan',
+    TK: 'Tokelau',
+    TL: 'East Timor',
+    TM: 'Turkmenistan',
+    TN: 'Tunisia',
+    TO: 'Tonga',
+    TR: 'Turkey',
+    TT: 'Trinidad and Tobago',
+    TV: 'Tuvalu',
+    TW: 'Taiwan',
+    TZ: 'Tanzania',
+    UA: 'Ukraine',
+    UG: 'Uganda',
+    UM: 'Midway Islands',
+    US: 'United States',
+    UY: 'Uruguay',
+    UZ: 'Uzbekistan',
+    VA: 'Vatican City',
+    VC: 'Saint Vincent and the Grenadines',
+    VE: 'Venezuela',
+    VG: 'British Virgin Islands',
+    VI: 'U.S. Virgin Islands',
+    VN: 'Vietnam',
+    VU: 'Vanuatu',
+    XK: 'Kosovo',
+    WF: 'Wallis and Futuna',
+    WS: 'Samoa',
+    YE: 'Yemen',
+    YT: 'Mayotte',
+    ZA: 'South Africa',
+    ZM: 'Zambia',
+    ZW: 'Zimbabwe',
+    ZZ: 'Unknown Region'
+  }.with_indifferent_access
+
+  # The list of U.S. state codes and names used by the YouTube Analytics API.
+  # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province
+  US_STATES = {
+    AL: 'Alabama',
+    AK: 'Alaska',
+    AZ: 'Arizona',
+    AR: 'Arkansas',
+    CA: 'California',
+    CO: 'Colorado',
+    CT: 'Connecticut',
+    DE: 'Delaware',
+    FL: 'Florida',
+    GA: 'Georgia',
+    HI: 'Hawaii',
+    ID: 'Idaho',
+    IL: 'Illinois',
+    IN: 'Indiana',
+    IA: 'Iowa',
+    KS: 'Kansas',
+    KY: 'Kentucky',
+    LA: 'Louisiana',
+    ME: 'Maine',
+    MD: 'Maryland',
+    MA: 'Massachusetts',
+    MI: 'Michigan',
+    MN: 'Minnesota',
+    MS: 'Mississippi',
+    MO: 'Missouri',
+    MT: 'Montana',
+    NE: 'Nebraska',
+    NV: 'Nevada',
+    NH: 'New Hampshire',
+    NJ: 'New Jersey',
+    NM: 'New Mexico',
+    NY: 'New York',
+    NC: 'North Carolina',
+    ND: 'North Dakota',
+    OH: 'Ohio',
+    OK: 'Oklahoma',
+    OR: 'Oregon',
+    PA: 'Pennsylvania',
+    RI: 'Rhode Island',
+    SC: 'South Carolina',
+    SD: 'South Dakota',
+    TN: 'Tennessee',
+    TX: 'Texas',
+    UT: 'Utah',
+    VT: 'Vermont',
+    VA: 'Virginia',
+    WA: 'Washington',
+    WV: 'West Virginia',
+    WI: 'Wisconsin',
+    WY: 'Wyoming',
+    DC: 'District of Columbia',
+    AS: 'American Samoa',
+    GU: 'Guam',
+    MP: 'Northern Mariana Islands',
+    PR: 'Puerto Rico',
+    UM: 'United States Minor Outlying Islands',
+    VI: 'Virgin Islands, U.S.',
+    ZZ: 'Unknown Region'
+  }.with_indifferent_access
+end