lib/facebook_ads/ad_objects/user.rb (600 lines of code) (raw):
# Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
#
# You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
# copy, modify, and distribute this software in source code or binary form for use
# in connection with the web services and APIs provided by Facebook.
#
# As with any software that integrates with the Facebook platform, your use of
# this software is subject to the Facebook Platform Policy
# [http://developers.facebook.com/policy/]. This copyright notice shall be
# included in all copies or substantial portions of the software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
# FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
# IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
# FB:AUTOGEN
module FacebookAds
# This class is auto-generated.
# For any issues or feature requests related to this class, please let us know
# on github and we'll fix in our codegen framework. We'll not be able to accept
# pull request for this class.
class User < AdObject
LOCAL_NEWS_MEGAPHONE_DISMISS_STATUS = [
"NO",
"YES",
]
LOCAL_NEWS_SUBSCRIPTION_STATUS = [
"STATUS_OFF",
"STATUS_ON",
]
FILTERING = [
"ema",
"groups",
"groups_social",
]
TYPE = [
"content_update",
"generic",
]
field :about, 'string'
field :age_range, 'AgeRange'
field :birthday, 'string'
field :cover, 'UserCoverPhoto'
field :currency, 'Currency'
field :education, { list: 'object' }
field :email, 'string'
field :favorite_athletes, { list: 'Experience' }
field :favorite_teams, { list: 'Experience' }
field :first_name, 'string'
field :gender, 'string'
field :hometown, 'Page'
field :id, 'string'
field :inspirational_people, { list: 'Experience' }
field :install_type, 'string'
field :installed, 'bool'
field :is_guest_user, 'bool'
field :languages, { list: 'Experience' }
field :last_name, 'string'
field :link, 'string'
field :local_news_megaphone_dismiss_status, 'bool'
field :local_news_subscription_status, 'bool'
field :locale, 'string'
field :location, 'Page'
field :meeting_for, { list: 'string' }
field :middle_name, 'string'
field :name, 'string'
field :name_format, 'string'
field :payment_pricepoints, 'PaymentPricepoints'
field :political, 'string'
field :profile_pic, 'string'
field :quotes, 'string'
field :relationship_status, 'string'
field :shared_login_upgrade_required_by, 'datetime'
field :short_name, 'string'
field :significant_other, 'User'
field :sports, { list: 'Experience' }
field :supports_donate_button_in_live_video, 'bool'
field :third_party_id, 'string'
field :timezone, 'double'
field :token_for_business, 'string'
field :updated_time, 'datetime'
field :verified, 'bool'
field :video_upload_limits, 'VideoUploadLimits'
field :website, 'string'
has_edge :access_tokens do |edge|
edge.delete
edge.post 'User' do |api|
api.has_param :business_app, 'int'
api.has_param :page_id, 'string'
api.has_param :scope, { list: 'Permission' }
end
end
has_edge :accounts do |edge|
edge.get 'Page' do |api|
api.has_param :is_place, 'bool'
api.has_param :is_promotable, 'bool'
end
edge.post 'Page' do |api|
api.has_param :about, 'string'
api.has_param :address, 'string'
api.has_param :category, 'int'
api.has_param :category_enum, 'string'
api.has_param :category_list, { list: 'string' }
api.has_param :city_id, 'string'
api.has_param :coordinates, 'object'
api.has_param :cover_photo, 'object'
api.has_param :description, 'string'
api.has_param :ignore_coordinate_warnings, 'bool'
api.has_param :location, 'object'
api.has_param :name, 'string'
api.has_param :phone, 'string'
api.has_param :picture, 'string'
api.has_param :website, 'string'
api.has_param :zip, 'string'
end
end
has_edge :ad_studies do |edge|
edge.get 'AdStudy'
edge.post 'AdStudy' do |api|
api.has_param :cells, { list: 'object' }
api.has_param :client_business, 'string'
api.has_param :confidence_level, 'double'
api.has_param :cooldown_start_time, 'int'
api.has_param :description, 'string'
api.has_param :end_time, 'int'
api.has_param :name, 'string'
api.has_param :objectives, { list: 'object' }
api.has_param :observation_end_time, 'int'
api.has_param :start_time, 'int'
api.has_param :type, { enum: -> { AdStudy::TYPE }}
api.has_param :viewers, { list: 'int' }
end
end
has_edge :adaccounts do |edge|
edge.get 'AdAccount'
end
has_edge :albums do |edge|
edge.get 'Album'
end
has_edge :applications do |edge|
edge.post 'User' do |api|
api.has_param :business_app, 'int'
end
end
has_edge :apprequestformerrecipients do |edge|
edge.get 'AppRequestFormerRecipient'
end
has_edge :apprequests do |edge|
edge.get 'AppRequest'
end
has_edge :assigned_ad_accounts do |edge|
edge.get 'AdAccount'
end
has_edge :assigned_business_asset_groups do |edge|
edge.get 'BusinessAssetGroup' do |api|
api.has_param :contained_asset_id, 'string'
end
end
has_edge :assigned_pages do |edge|
edge.get 'Page'
end
has_edge :assigned_product_catalogs do |edge|
edge.get 'ProductCatalog'
end
has_edge :business_users do |edge|
edge.get 'BusinessUser'
end
has_edge :businesses do |edge|
edge.delete do |api|
api.has_param :business, 'string'
end
edge.get 'Business'
edge.post 'Business' do |api|
api.has_param :child_business_external_id, 'string'
api.has_param :email, 'string'
api.has_param :name, 'string'
api.has_param :primary_page, 'string'
api.has_param :sales_rep_email, 'string'
api.has_param :survey_business_type, { enum: -> { Business::SURVEY_BUSINESS_TYPE }}
api.has_param :survey_num_assets, 'int'
api.has_param :survey_num_people, 'int'
api.has_param :timezone_id, 'int'
api.has_param :vertical, { enum: -> { Business::VERTICAL }}
end
end
has_edge :conversations do |edge|
edge.get 'UnifiedThread' do |api|
api.has_param :folder, 'string'
api.has_param :tags, { list: 'string' }
api.has_param :user_id, 'string'
end
end
has_edge :custom_labels do |edge|
edge.get 'PageUserMessageThreadLabel'
end
has_edge :events do |edge|
edge.get 'Event' do |api|
api.has_param :include_canceled, 'bool'
api.has_param :type, { enum: -> { Event::TYPE }}
end
end
has_edge :feed do |edge|
edge.get 'Post' do |api|
api.has_param :include_hidden, 'bool'
api.has_param :q, 'string'
api.has_param :show_expired, 'bool'
api.has_param :since, 'datetime'
api.has_param :until, 'datetime'
api.has_param :with, 'string'
end
edge.post 'Post' do |api|
api.has_param :actions, 'object'
api.has_param :adaptive_type, 'string'
api.has_param :album_id, 'string'
api.has_param :android_key_hash, 'string'
api.has_param :animated_effect_id, 'int'
api.has_param :application_id, 'string'
api.has_param :asked_fun_fact_prompt_id, 'int'
api.has_param :asset3d_id, 'int'
api.has_param :associated_id, 'string'
api.has_param :attach_place_suggestion, 'bool'
api.has_param :attached_media, { list: 'object' }
api.has_param :audience_exp, 'bool'
api.has_param :backdated_time, 'datetime'
api.has_param :backdated_time_granularity, { enum: -> { Post::BACKDATED_TIME_GRANULARITY }}
api.has_param :call_to_action, 'object'
api.has_param :caption, 'string'
api.has_param :checkin_entry_point, { enum: -> { Post::CHECKIN_ENTRY_POINT }}
api.has_param :child_attachments, { list: 'object' }
api.has_param :client_mutation_id, 'string'
api.has_param :composer_entry_picker, 'string'
api.has_param :composer_entry_point, 'string'
api.has_param :composer_entry_time, 'int'
api.has_param :composer_session_events_log, 'string'
api.has_param :composer_session_id, 'string'
api.has_param :composer_source_surface, 'string'
api.has_param :composer_type, 'string'
api.has_param :connection_class, 'string'
api.has_param :content_attachment, 'string'
api.has_param :coordinates, 'object'
api.has_param :cta_link, 'string'
api.has_param :cta_type, 'string'
api.has_param :description, 'string'
api.has_param :direct_share_status, 'int'
api.has_param :expanded_height, 'int'
api.has_param :expanded_width, 'int'
api.has_param :feed_targeting, 'object'
api.has_param :formatting, { enum: -> { Post::FORMATTING }}
api.has_param :fun_fact_prompt_id, 'int'
api.has_param :fun_fact_toastee_id, 'int'
api.has_param :has_nickname, 'bool'
api.has_param :height, 'int'
api.has_param :holiday_card, 'string'
api.has_param :home_checkin_city_id, 'object'
api.has_param :image_crops, 'hash'
api.has_param :implicit_with_tags, { list: 'int' }
api.has_param :instant_game_entry_point_data, 'string'
api.has_param :ios_bundle_id, 'string'
api.has_param :is_backout_draft, 'bool'
api.has_param :is_boost_intended, 'bool'
api.has_param :is_explicit_location, 'bool'
api.has_param :is_explicit_share, 'bool'
api.has_param :is_group_linking_post, 'bool'
api.has_param :is_photo_container, 'bool'
api.has_param :link, 'string'
api.has_param :location_source_id, 'string'
api.has_param :manual_privacy, 'bool'
api.has_param :message, 'string'
api.has_param :multi_share_end_card, 'bool'
api.has_param :multi_share_optimized, 'bool'
api.has_param :name, 'string'
api.has_param :nectar_module, 'string'
api.has_param :object_attachment, 'string'
api.has_param :offer_like_post_id, 'int'
api.has_param :og_action_type_id, 'string'
api.has_param :og_hide_object_attachment, 'bool'
api.has_param :og_icon_id, 'string'
api.has_param :og_object_id, 'string'
api.has_param :og_phrase, 'string'
api.has_param :og_set_profile_badge, 'bool'
api.has_param :og_suggestion_mechanism, 'string'
api.has_param :page_recommendation, 'string'
api.has_param :picture, 'string'
api.has_param :place, 'object'
api.has_param :place_attachment_setting, { enum: -> { Post::PLACE_ATTACHMENT_SETTING }}
api.has_param :place_list, 'string'
api.has_param :place_list_data, { list: 'string' }
api.has_param :post_surfaces_blacklist, { list: { enum: -> { Post::POST_SURFACES_BLACKLIST }} }
api.has_param :posting_to_redspace, { enum: -> { Post::POSTING_TO_REDSPACE }}
api.has_param :privacy, 'string'
api.has_param :prompt_id, 'string'
api.has_param :prompt_tracking_string, 'string'
api.has_param :properties, 'object'
api.has_param :proxied_app_id, 'string'
api.has_param :publish_event_id, 'int'
api.has_param :published, 'bool'
api.has_param :quote, 'string'
api.has_param :react_mode_metadata, 'string'
api.has_param :ref, { list: 'string' }
api.has_param :referenceable_image_ids, { list: 'string' }
api.has_param :referral_id, 'string'
api.has_param :scheduled_publish_time, 'datetime'
api.has_param :source, 'string'
api.has_param :sponsor_id, 'string'
api.has_param :sponsor_relationship, 'int'
api.has_param :suggested_place_id, 'object'
api.has_param :tags, { list: 'int' }
api.has_param :target_surface, { enum: -> { Post::TARGET_SURFACE }}
api.has_param :targeting, 'object'
api.has_param :text_format_metadata, 'string'
api.has_param :text_format_preset_id, 'string'
api.has_param :text_only_place, 'string'
api.has_param :throwback_camera_roll_media, 'string'
api.has_param :thumbnail, 'file'
api.has_param :time_since_original_post, 'int'
api.has_param :title, 'string'
api.has_param :tracking_info, 'string'
api.has_param :unpublished_content_type, { enum: -> { Post::UNPUBLISHED_CONTENT_TYPE }}
api.has_param :user_selected_tags, 'bool'
api.has_param :video_start_time_ms, 'int'
api.has_param :viewer_coordinates, 'object'
api.has_param :width, 'int'
end
end
has_edge :friends do |edge|
edge.get 'User' do |api|
api.has_param :uid, 'int'
end
end
has_edge :fundraisers do |edge|
edge.post 'FundraiserPersonToCharity' do |api|
api.has_param :charity_id, 'string'
api.has_param :cover_photo, 'file'
api.has_param :currency, 'string'
api.has_param :description, 'string'
api.has_param :end_time, 'int'
api.has_param :external_event_name, 'string'
api.has_param :external_event_start_time, 'int'
api.has_param :external_event_uri, 'string'
api.has_param :external_fundraiser_uri, 'string'
api.has_param :external_id, 'string'
api.has_param :fundraiser_type, { enum: -> { FundraiserPersonToCharity::FUNDRAISER_TYPE }}
api.has_param :goal_amount, 'int'
api.has_param :name, 'string'
api.has_param :page_id, 'string'
end
end
has_edge :game_items do |edge|
edge.post do |api|
api.has_param :action, { enum: %w{CONSUME DROP MARK }}
api.has_param :app_id, 'string'
api.has_param :drop_table_id, 'string'
api.has_param :ext_id, 'string'
api.has_param :item_id, 'string'
api.has_param :quantity, 'int'
end
end
has_edge :game_times do |edge|
edge.post do |api|
api.has_param :action, { enum: %w{END HEARTBEAT START }}
end
end
has_edge :groups do |edge|
edge.get 'Group' do |api|
api.has_param :admin_only, 'bool'
api.has_param :parent, 'string'
end
end
has_edge :ids_for_apps do |edge|
edge.get 'UserIdForApp' do |api|
api.has_param :app, 'int'
end
end
has_edge :ids_for_business do |edge|
edge.get 'UserIdForApp' do |api|
api.has_param :app, 'int'
end
end
has_edge :ids_for_pages do |edge|
edge.get 'UserIdForPage' do |api|
api.has_param :page, 'int'
end
end
has_edge :likes do |edge|
edge.get 'Page' do |api|
api.has_param :target_id, 'string'
end
end
has_edge :live_videos do |edge|
edge.get 'LiveVideo' do |api|
api.has_param :broadcast_status, { list: { enum: -> { LiveVideo::BROADCAST_STATUS }} }
api.has_param :source, { enum: -> { LiveVideo::SOURCE }}
end
edge.post 'LiveVideo' do |api|
api.has_param :content_tags, { list: 'string' }
api.has_param :description, 'string'
api.has_param :enable_backup_ingest, 'bool'
api.has_param :encoding_settings, 'string'
api.has_param :fisheye_video_cropped, 'bool'
api.has_param :front_z_rotation, 'double'
api.has_param :is_audio_only, 'bool'
api.has_param :is_spherical, 'bool'
api.has_param :original_fov, 'int'
api.has_param :planned_start_time, 'int'
api.has_param :privacy, 'string'
api.has_param :projection, { enum: -> { LiveVideo::PROJECTION }}
api.has_param :published, 'bool'
api.has_param :schedule_custom_profile_image, 'file'
api.has_param :spatial_audio_format, { enum: -> { LiveVideo::SPATIAL_AUDIO_FORMAT }}
api.has_param :status, { enum: -> { LiveVideo::STATUS }}
api.has_param :stereoscopic_mode, { enum: -> { LiveVideo::STEREOSCOPIC_MODE }}
api.has_param :stop_on_delete_stream, 'bool'
api.has_param :stream_type, { enum: -> { LiveVideo::STREAM_TYPE }}
api.has_param :title, 'string'
end
end
has_edge :music do |edge|
edge.get 'Page' do |api|
api.has_param :target_id, 'string'
end
end
has_edge :notifications do |edge|
edge.post 'User' do |api|
api.has_param :filtering, { list: { enum: -> { User::FILTERING }} }
api.has_param :href, 'object'
api.has_param :notif_ids, { list: 'string' }
api.has_param :read, 'bool'
api.has_param :ref, 'string'
api.has_param :seen, 'bool'
api.has_param :template, 'object'
api.has_param :type, { enum: -> { User::TYPE }}
end
end
has_edge :payment_transactions do |edge|
edge.get 'PaymentEnginePayment'
end
has_edge :permissions do |edge|
edge.delete do |api|
api.has_param :permission, 'string'
end
edge.get 'Permission' do |api|
api.has_param :permission, 'string'
api.has_param :status, { enum: -> { Permission::STATUS }}
end
end
has_edge :personal_ad_accounts do |edge|
edge.get 'AdAccount'
end
has_edge :photos do |edge|
edge.get 'Photo' do |api|
api.has_param :type, { enum: -> { Photo::TYPE }}
end
edge.post 'Photo' do |api|
api.has_param :aid, 'string'
api.has_param :allow_spherical_photo, 'bool'
api.has_param :alt_text_custom, 'string'
api.has_param :android_key_hash, 'string'
api.has_param :application_id, 'string'
api.has_param :attempt, 'int'
api.has_param :audience_exp, 'bool'
api.has_param :backdated_time, 'datetime'
api.has_param :backdated_time_granularity, { enum: -> { Photo::BACKDATED_TIME_GRANULARITY }}
api.has_param :caption, 'string'
api.has_param :composer_session_id, 'string'
api.has_param :direct_share_status, 'int'
api.has_param :feed_targeting, 'object'
api.has_param :filter_type, 'int'
api.has_param :full_res_is_coming_later, 'bool'
api.has_param :initial_view_heading_override_degrees, 'int'
api.has_param :initial_view_pitch_override_degrees, 'int'
api.has_param :initial_view_vertical_fov_override_degrees, 'int'
api.has_param :ios_bundle_id, 'string'
api.has_param :is_explicit_location, 'bool'
api.has_param :is_explicit_place, 'bool'
api.has_param :manual_privacy, 'bool'
api.has_param :message, 'string'
api.has_param :name, 'string'
api.has_param :no_story, 'bool'
api.has_param :offline_id, 'int'
api.has_param :og_action_type_id, 'string'
api.has_param :og_icon_id, 'string'
api.has_param :og_object_id, 'string'
api.has_param :og_phrase, 'string'
api.has_param :og_set_profile_badge, 'bool'
api.has_param :og_suggestion_mechanism, 'string'
api.has_param :place, 'object'
api.has_param :privacy, 'string'
api.has_param :profile_id, 'int'
api.has_param :proxied_app_id, 'string'
api.has_param :published, 'bool'
api.has_param :qn, 'string'
api.has_param :scheduled_publish_time, 'int'
api.has_param :spherical_metadata, 'hash'
api.has_param :sponsor_id, 'string'
api.has_param :sponsor_relationship, 'int'
api.has_param :tags, { list: 'object' }
api.has_param :target_id, 'int'
api.has_param :targeting, 'object'
api.has_param :time_since_original_post, 'int'
api.has_param :uid, 'int'
api.has_param :unpublished_content_type, { enum: -> { Photo::UNPUBLISHED_CONTENT_TYPE }}
api.has_param :url, 'string'
api.has_param :user_selected_tags, 'bool'
api.has_param :vault_image_id, 'string'
end
end
has_edge :picture do |edge|
edge.get 'ProfilePictureSource' do |api|
api.has_param :breaking_change, { enum: -> { ProfilePictureSource::BREAKING_CHANGE }}
api.has_param :height, 'int'
api.has_param :redirect, 'bool'
api.has_param :type, { enum: -> { ProfilePictureSource::TYPE }}
api.has_param :width, 'int'
end
end
has_edge :posts do |edge|
edge.get 'Post' do |api|
api.has_param :include_hidden, 'bool'
api.has_param :q, 'string'
api.has_param :show_expired, 'bool'
api.has_param :since, 'datetime'
api.has_param :until, 'datetime'
api.has_param :with, 'string'
end
end
has_edge :rich_media_documents do |edge|
edge.get 'Canvas' do |api|
api.has_param :query, 'string'
end
end
has_edge :staging_resources do |edge|
edge.post 'User' do |api|
api.has_param :file, 'file'
end
end
has_edge :videos do |edge|
edge.get 'AdVideo' do |api|
api.has_param :type, { enum: -> { AdVideo::TYPE }}
end
edge.post 'AdVideo' do |api|
api.has_param :adaptive_type, 'string'
api.has_param :animated_effect_id, 'int'
api.has_param :application_id, 'string'
api.has_param :asked_fun_fact_prompt_id, 'int'
api.has_param :audio_story_wave_animation_handle, 'string'
api.has_param :composer_entry_picker, 'string'
api.has_param :composer_entry_point, 'string'
api.has_param :composer_entry_time, 'int'
api.has_param :composer_session_events_log, 'string'
api.has_param :composer_session_id, 'string'
api.has_param :composer_source_surface, 'string'
api.has_param :composer_type, 'string'
api.has_param :container_type, { enum: -> { AdVideo::CONTAINER_TYPE }}
api.has_param :content_category, { enum: -> { AdVideo::CONTENT_CATEGORY }}
api.has_param :creative_tools, 'string'
api.has_param :description, 'string'
api.has_param :direct_share_status, 'int'
api.has_param :embeddable, 'bool'
api.has_param :end_offset, 'int'
api.has_param :fbuploader_video_file_chunk, 'string'
api.has_param :file_size, 'int'
api.has_param :file_url, 'string'
api.has_param :fisheye_video_cropped, 'bool'
api.has_param :formatting, { enum: -> { AdVideo::FORMATTING }}
api.has_param :fov, 'int'
api.has_param :front_z_rotation, 'double'
api.has_param :fun_fact_prompt_id, 'int'
api.has_param :fun_fact_toastee_id, 'int'
api.has_param :guide, { list: { list: 'int' } }
api.has_param :guide_enabled, 'bool'
api.has_param :has_nickname, 'bool'
api.has_param :holiday_card, 'string'
api.has_param :initial_heading, 'int'
api.has_param :initial_pitch, 'int'
api.has_param :instant_game_entry_point_data, 'string'
api.has_param :is_boost_intended, 'bool'
api.has_param :is_explicit_share, 'bool'
api.has_param :is_group_linking_post, 'bool'
api.has_param :is_voice_clip, 'bool'
api.has_param :location_source_id, 'string'
api.has_param :manual_privacy, 'bool'
api.has_param :no_story, 'bool'
api.has_param :offer_like_post_id, 'int'
api.has_param :og_action_type_id, 'string'
api.has_param :og_icon_id, 'string'
api.has_param :og_object_id, 'string'
api.has_param :og_phrase, 'string'
api.has_param :og_suggestion_mechanism, 'string'
api.has_param :original_fov, 'int'
api.has_param :original_projection_type, { enum: -> { AdVideo::ORIGINAL_PROJECTION_TYPE }}
api.has_param :privacy, 'string'
api.has_param :publish_event_id, 'int'
api.has_param :react_mode_metadata, 'string'
api.has_param :referenced_sticker_id, 'string'
api.has_param :replace_video_id, 'string'
api.has_param :slideshow_spec, 'hash'
api.has_param :source, 'string'
api.has_param :source_instagram_media_id, 'string'
api.has_param :spherical, 'bool'
api.has_param :sponsor_id, 'string'
api.has_param :start_offset, 'int'
api.has_param :swap_mode, { enum: -> { AdVideo::SWAP_MODE }}
api.has_param :text_format_metadata, 'string'
api.has_param :throwback_camera_roll_media, 'string'
api.has_param :thumb, 'file'
api.has_param :time_since_original_post, 'int'
api.has_param :title, 'string'
api.has_param :transcode_setting_properties, 'string'
api.has_param :unpublished_content_type, { enum: -> { AdVideo::UNPUBLISHED_CONTENT_TYPE }}
api.has_param :upload_phase, { enum: -> { AdVideo::UPLOAD_PHASE }}
api.has_param :upload_session_id, 'string'
api.has_param :upload_setting_properties, 'string'
api.has_param :video_file_chunk, 'string'
api.has_param :video_id_original, 'string'
api.has_param :video_start_time_ms, 'int'
api.has_param :waterfall_id, 'string'
end
end
end
end