bonio-facebookbusiness 0.13.0.0

data/lib/facebook_ads/ad_objects/group.rb

@@ -0,0 +1,572 @@
+# 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 Group < AdObject
+    JOIN_SETTING = [
+      "ADMIN_ONLY",
+      "ANYONE",
+      "NONE",
+    ]
+
+    POST_PERMISSIONS = [
+      "0",
+      "1",
+      "2",
+    ]
+
+    PURPOSE = [
+      "BOOKS",
+      "CASUAL",
+      "CLOSE_FRIENDS",
+      "CLUB",
+      "COUPLE",
+      "COWORKERS",
+      "CUSTOM",
+      "DEALS",
+      "EPHEMERAL",
+      "EVENT_PLANNING",
+      "FAMILY",
+      "FANDOM_RADAR",
+      "FANTASY_LEAGUE",
+      "FITNESS",
+      "FOR_SALE",
+      "FOR_WORK",
+      "FRATERNITY",
+      "GAME",
+      "HEALTH_SUPPORT",
+      "HIGH_SCHOOL_FORUM",
+      "JOBS",
+      "LEARNING",
+      "MENTORSHIP",
+      "MUSIC_CASA_BUNDLE",
+      "NEIGHBORS",
+      "NONE",
+      "OCULUS",
+      "PARENTING",
+      "PARENTS",
+      "PROJECT",
+      "REAL_WORLD",
+      "REAL_WORLD_AT_WORK",
+      "SCHOOL_CLASS",
+      "SORORITY",
+      "SPORTS",
+      "SPORTS_ACTIVITY",
+      "STREAMER",
+      "STUDY_GROUP",
+      "SUPPORT",
+      "TEAMMATES",
+      "THEME",
+      "TOGETHER_VR",
+      "TRAVEL_PLANNING",
+      "WORK_ANNOUNCEMENT",
+      "WORK_DEMO_GROUP",
+      "WORK_DISCUSSION",
+      "WORK_EPHEMERAL",
+      "WORK_FEEDBACK",
+      "WORK_FOR_SALE",
+      "WORK_GARDEN",
+      "WORK_GUEST_GROUP",
+      "WORK_LEARNING",
+      "WORK_MENTORSHIP",
+      "WORK_MULTI_COMPANY",
+      "WORK_RECRUITING",
+      "WORK_RESUME_REVIEW",
+      "WORK_SOCIAL",
+      "WORK_STAGES",
+      "WORK_TEAM",
+      "WORK_TEAMWORK",
+      "WORK_VC_CALL",
+    ]
+
+    GROUP_TYPE = [
+      "BOOKS",
+      "CASUAL",
+      "CLOSE_FRIENDS",
+      "CLUB",
+      "COUPLE",
+      "COWORKERS",
+      "CUSTOM",
+      "DEALS",
+      "EPHEMERAL",
+      "EVENT_PLANNING",
+      "FAMILY",
+      "FANDOM_RADAR",
+      "FANTASY_LEAGUE",
+      "FITNESS",
+      "FOR_SALE",
+      "FOR_WORK",
+      "FRATERNITY",
+      "GAME",
+      "HEALTH_SUPPORT",
+      "HIGH_SCHOOL_FORUM",
+      "JOBS",
+      "LEARNING",
+      "MENTORSHIP",
+      "MUSIC_CASA_BUNDLE",
+      "NEIGHBORS",
+      "NONE",
+      "OCULUS",
+      "PARENTING",
+      "PARENTS",
+      "PROJECT",
+      "REAL_WORLD",
+      "REAL_WORLD_AT_WORK",
+      "SCHOOL_CLASS",
+      "SORORITY",
+      "SPORTS",
+      "SPORTS_ACTIVITY",
+      "STREAMER",
+      "STUDY_GROUP",
+      "SUPPORT",
+      "TEAMMATES",
+      "THEME",
+      "TOGETHER_VR",
+      "TRAVEL_PLANNING",
+      "WORK_ANNOUNCEMENT",
+      "WORK_DEMO_GROUP",
+      "WORK_DISCUSSION",
+      "WORK_EPHEMERAL",
+      "WORK_FEEDBACK",
+      "WORK_FOR_SALE",
+      "WORK_GARDEN",
+      "WORK_GUEST_GROUP",
+      "WORK_LEARNING",
+      "WORK_MENTORSHIP",
+      "WORK_MULTI_COMPANY",
+      "WORK_RECRUITING",
+      "WORK_RESUME_REVIEW",
+      "WORK_SOCIAL",
+      "WORK_STAGES",
+      "WORK_TEAM",
+      "WORK_TEAMWORK",
+      "WORK_VC_CALL",
+    ]
+
+
+    field :archived, 'bool'
+    field :cover, 'CoverPhoto'
+    field :created_time, 'datetime'
+    field :description, 'string'
+    field :email, 'string'
+    field :icon, 'string'
+    field :id, 'string'
+    field :link, 'string'
+    field :member_count, 'int'
+    field :member_request_count, 'int'
+    field :name, 'string'
+    field :parent, 'object'
+    field :permissions, { list: 'string' }
+    field :privacy, 'string'
+    field :purpose, 'string'
+    field :subdomain, 'string'
+    field :updated_time, 'datetime'
+    field :venue, 'Location'
+    has_no_delete
+
+    has_edge :admins do |edge|
+      edge.delete do |api|
+        api.has_param :uid, 'int'
+      end
+      edge.post 'Group' do |api|
+        api.has_param :uid, 'int'
+      end
+    end
+
+    has_edge :albums do |edge|
+      edge.get 'Album'
+      edge.post 'Album' do |api|
+        api.has_param :contributors, { list: 'int' }
+        api.has_param :description, 'string'
+        api.has_param :is_default, 'bool'
+        api.has_param :location, 'string'
+        api.has_param :make_shared_album, 'bool'
+        api.has_param :message, 'string'
+        api.has_param :name, 'string'
+        api.has_param :place, 'object'
+        api.has_param :privacy, 'string'
+        api.has_param :tags, { list: 'int' }
+        api.has_param :visible, 'string'
+      end
+    end
+
+    has_edge :docs do |edge|
+      edge.get
+    end
+
+    has_edge :events do |edge|
+      edge.get 'Event'
+    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 :files do |edge|
+      edge.get
+    end
+
+    has_edge :groups do |edge|
+      edge.get 'Group'
+      edge.post 'Group' do |api|
+        api.has_param :admin, 'int'
+        api.has_param :description, 'string'
+        api.has_param :group_icon_id, 'object'
+        api.has_param :group_type, { enum: -> { Group::GROUP_TYPE }}
+        api.has_param :join_setting, { enum: -> { Group::JOIN_SETTING }}
+        api.has_param :name, 'string'
+        api.has_param :parent_id, 'object'
+        api.has_param :post_permissions, { enum: -> { Group::POST_PERMISSIONS }}
+        api.has_param :post_requires_admin_approval, 'bool'
+        api.has_param :privacy, 'string'
+        api.has_param :ref, '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 :members do |edge|
+      edge.delete do |api|
+        api.has_param :email, 'string'
+        api.has_param :member, 'int'
+      end
+      edge.post 'Group' do |api|
+        api.has_param :email, 'string'
+        api.has_param :from, 'int'
+        api.has_param :member, 'int'
+        api.has_param :rate, 'int'
+        api.has_param :source, 'string'
+      end
+    end
+
+    has_edge :opted_in_members do |edge|
+      edge.get 'User'
+    end
+
+    has_edge :photos do |edge|
+      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 :shift_settings do |edge|
+      edge.post do |api|
+        api.has_param :external_id, 'string'
+        api.has_param :shift_feature_setting, { enum: %w{ALL_FEATURES_OFF ALL_FEATURES_ON SHIFT_COVER_ONLY_ON SHIFT_VIEWER_ONLY_ON }}
+      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 :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 :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 :publish_event_id, 'int'
+        api.has_param :published, 'bool'
+        api.has_param :react_mode_metadata, 'string'
+        api.has_param :referenced_sticker_id, 'string'
+        api.has_param :replace_video_id, 'string'
+        api.has_param :scheduled_publish_time, 'int'
+        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 :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