aws-sdk-pinpoint 1.23.0 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f730e83d370bc6978da941eec416c737fa782bd7
-  data.tar.gz: 6525be50c6e2e1dc585ee2704eced156f5e06e8b
+  metadata.gz: c38af6d1dff6f4237015e8b926625e049f152efc
+  data.tar.gz: b5edaa680c9989ae2323d9ecc65d29a4ff4ec224
 SHA512:
-  metadata.gz: 982449f45b302b40c860dbf1af8333dc57ebc80ad52f590e5e01c8f541f048334f4b39690d0629dc18c720364e7e609a99d0a2b6067453886a59dfefc6da13df
-  data.tar.gz: 5a087c541777b0dbbb9471c1cf44ce38dc9f96adc352319dff150b4c751d4d4bfa0286a5561a6ff14a85b9a95c551b2db4df1f4e110b96b01dd0a5d10f5f9cc0
+  metadata.gz: de2d899b44c6244b798b55ed828a654b5feacca75e2d1daff71df438510c006b634cb8ef7e2afdc4ea5ab0e5ce419362dfe2719899d8dc05cd3c05a6f6d0c0f2
+  data.tar.gz: 923e7316322d8d4ff0312bcb7b5cd3753444bb1158ee399f6c275b0b82ed24ce76b8842e11aa84ef0c823c6695d537cba8be2fd151712a1560a2024d793cfbda

data/lib/aws-sdk-pinpoint.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-pinpoint/customizations'
 # @service
 module Aws::Pinpoint
 
-  GEM_VERSION = '1.23.0'
+  GEM_VERSION = '1.24.0'
 
 end

data/lib/aws-sdk-pinpoint/client.rb

@@ -254,10 +254,11 @@ module Aws::Pinpoint
 
     # @!group API Operations
 
-    # Creates or updates an app.
+    # Creates an application.
     #
     # @option params [required, Types::CreateApplicationRequest] :create_application_request
-    #   Application Request.
+    #   Specifies the display name of an application and the tags to associate
+    #   with the application.
     #
     # @return [Types::CreateAppResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -267,7 +268,7 @@ module Aws::Pinpoint
     #
     #   resp = client.create_app({
     #     create_application_request: { # required
-    #       name: "__string",
+    #       name: "__string", # required
     #       tags: {
     #         "__string" => "__string",
     #       },
@@ -291,12 +292,13 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Creates or updates a campaign.
+    # Creates a new campaign for an application or updates the settings of
+    # an existing campaign for an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::WriteCampaignRequest] :write_campaign_request
-    #   Used to create a campaign.
+    #   Specifies the configuration and other settings for a campaign.
     #
     # @return [Types::CreateCampaignResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -370,7 +372,7 @@ module Aws::Pinpoint
     #               body: "__string",
     #               from_address: "__string",
     #               html_body: "__string",
-    #               title: "__string",
+    #               title: "__string", # required
     #             },
     #             gcm_message: {
     #               action: "OPEN_APP", # accepts OPEN_APP, DEEP_LINK, URL
@@ -395,25 +397,25 @@ module Aws::Pinpoint
     #           schedule: {
     #             end_time: "__string",
     #             event_filter: {
-    #               dimensions: {
+    #               dimensions: { # required
     #                 attributes: {
     #                   "__string" => {
     #                     attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                 },
     #                 event_type: {
     #                   dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                   values: ["__string"],
+    #                   values: ["__string"], # required
     #                 },
     #                 metrics: {
     #                   "__string" => {
-    #                     comparison_operator: "__string",
-    #                     value: 1.0,
+    #                     comparison_operator: "__string", # required
+    #                     value: 1.0, # required
     #                   },
     #                 },
     #               },
-    #               filter_type: "SYSTEM", # accepts SYSTEM, ENDPOINT
+    #               filter_type: "SYSTEM", # required, accepts SYSTEM, ENDPOINT
     #             },
     #             frequency: "ONCE", # accepts ONCE, HOURLY, DAILY, WEEKLY, MONTHLY, EVENT
     #             is_local_time: false,
@@ -421,10 +423,10 @@ module Aws::Pinpoint
     #               end: "__string",
     #               start: "__string",
     #             },
-    #             start_time: "__string",
+    #             start_time: "__string", # required
     #             timezone: "__string",
     #           },
-    #           size_percent: 1,
+    #           size_percent: 1, # required
     #           treatment_description: "__string",
     #           treatment_name: "__string",
     #         },
@@ -504,7 +506,7 @@ module Aws::Pinpoint
     #           body: "__string",
     #           from_address: "__string",
     #           html_body: "__string",
-    #           title: "__string",
+    #           title: "__string", # required
     #         },
     #         gcm_message: {
     #           action: "OPEN_APP", # accepts OPEN_APP, DEEP_LINK, URL
@@ -530,25 +532,25 @@ module Aws::Pinpoint
     #       schedule: {
     #         end_time: "__string",
     #         event_filter: {
-    #           dimensions: {
+    #           dimensions: { # required
     #             attributes: {
     #               "__string" => {
     #                 attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                 values: ["__string"],
+    #                 values: ["__string"], # required
     #               },
     #             },
     #             event_type: {
     #               dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #               values: ["__string"],
+    #               values: ["__string"], # required
     #             },
     #             metrics: {
     #               "__string" => {
-    #                 comparison_operator: "__string",
-    #                 value: 1.0,
+    #                 comparison_operator: "__string", # required
+    #                 value: 1.0, # required
     #               },
     #             },
     #           },
-    #           filter_type: "SYSTEM", # accepts SYSTEM, ENDPOINT
+    #           filter_type: "SYSTEM", # required, accepts SYSTEM, ENDPOINT
     #         },
     #         frequency: "ONCE", # accepts ONCE, HOURLY, DAILY, WEEKLY, MONTHLY, EVENT
     #         is_local_time: false,
@@ -556,7 +558,7 @@ module Aws::Pinpoint
     #           end: "__string",
     #           start: "__string",
     #         },
-    #         start_time: "__string",
+    #         start_time: "__string", # required
     #         timezone: "__string",
     #       },
     #       segment_id: "__string",
@@ -782,12 +784,13 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Creates an export job.
+    # Creates a new export job for an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::ExportJobRequest] :export_job_request
-    #   Export job request.
+    #   Specifies the settings for a job that exports endpoint definitions to
+    #   an Amazon Simple Storage Service (Amazon S3) bucket.
     #
     # @return [Types::CreateExportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -798,8 +801,8 @@ module Aws::Pinpoint
     #   resp = client.create_export_job({
     #     application_id: "__string", # required
     #     export_job_request: { # required
-    #       role_arn: "__string",
-    #       s3_url_prefix: "__string",
+    #       role_arn: "__string", # required
+    #       s3_url_prefix: "__string", # required
     #       segment_id: "__string",
     #       segment_version: 1,
     #     },
@@ -834,12 +837,13 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Creates or updates an import job.
+    # Creates a new import job for an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::ImportJobRequest] :import_job_request
-    #   Import job request.
+    #   Specifies the settings for a job that imports endpoint definitions
+    #   from an Amazon Simple Storage Service (Amazon S3) bucket.
     #
     # @return [Types::CreateImportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -852,10 +856,10 @@ module Aws::Pinpoint
     #     import_job_request: { # required
     #       define_segment: false,
     #       external_id: "__string",
-    #       format: "CSV", # accepts CSV, JSON
+    #       format: "CSV", # required, accepts CSV, JSON
     #       register_endpoints: false,
-    #       role_arn: "__string",
-    #       s3_url: "__string",
+    #       role_arn: "__string", # required
+    #       s3_url: "__string", # required
     #       segment_id: "__string",
     #       segment_name: "__string",
     #     },
@@ -894,12 +898,16 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Used to create or update a segment.
+    # Creates a new segment for an application or updates the configuration,
+    # dimension, and other settings for an existing segment that's
+    # associated with an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::WriteSegmentRequest] :write_segment_request
-    #   Segment definition.
+    #   Specifies the configuration, dimension, and other settings for a
+    #   segment. A WriteSegmentRequest object can include a Dimensions object
+    #   or a SegmentGroups object, but not both.
     #
     # @return [Types::CreateSegmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -914,64 +922,64 @@ module Aws::Pinpoint
     #         attributes: {
     #           "__string" => {
     #             attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #         },
     #         behavior: {
     #           recency: {
-    #             duration: "HR_24", # accepts HR_24, DAY_7, DAY_14, DAY_30
-    #             recency_type: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #             duration: "HR_24", # required, accepts HR_24, DAY_7, DAY_14, DAY_30
+    #             recency_type: "ACTIVE", # required, accepts ACTIVE, INACTIVE
     #           },
     #         },
     #         demographic: {
     #           app_version: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           channel: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           device_type: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           make: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           model: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           platform: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #         },
     #         location: {
     #           country: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           gps_point: {
-    #             coordinates: {
-    #               latitude: 1.0,
-    #               longitude: 1.0,
+    #             coordinates: { # required
+    #               latitude: 1.0, # required
+    #               longitude: 1.0, # required
     #             },
     #             range_in_kilometers: 1.0,
     #           },
     #         },
     #         metrics: {
     #           "__string" => {
-    #             comparison_operator: "__string",
-    #             value: 1.0,
+    #             comparison_operator: "__string", # required
+    #             value: 1.0, # required
     #           },
     #         },
     #         user_attributes: {
     #           "__string" => {
     #             attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #         },
     #       },
@@ -984,71 +992,71 @@ module Aws::Pinpoint
     #                 attributes: {
     #                   "__string" => {
     #                     attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                 },
     #                 behavior: {
     #                   recency: {
-    #                     duration: "HR_24", # accepts HR_24, DAY_7, DAY_14, DAY_30
-    #                     recency_type: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #                     duration: "HR_24", # required, accepts HR_24, DAY_7, DAY_14, DAY_30
+    #                     recency_type: "ACTIVE", # required, accepts ACTIVE, INACTIVE
     #                   },
     #                 },
     #                 demographic: {
     #                   app_version: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   channel: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   device_type: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   make: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   model: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   platform: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                 },
     #                 location: {
     #                   country: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   gps_point: {
-    #                     coordinates: {
-    #                       latitude: 1.0,
-    #                       longitude: 1.0,
+    #                     coordinates: { # required
+    #                       latitude: 1.0, # required
+    #                       longitude: 1.0, # required
     #                     },
     #                     range_in_kilometers: 1.0,
     #                   },
     #                 },
     #                 metrics: {
     #                   "__string" => {
-    #                     comparison_operator: "__string",
-    #                     value: 1.0,
+    #                     comparison_operator: "__string", # required
+    #                     value: 1.0, # required
     #                   },
     #                 },
     #                 user_attributes: {
     #                   "__string" => {
     #                     attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                 },
     #               },
     #             ],
     #             source_segments: [
     #               {
-    #                 id: "__string",
+    #                 id: "__string", # required
     #                 version: 1,
     #               },
     #             ],
@@ -1175,7 +1183,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Delete an ADM channel.
+    # Disables the ADM channel for an application and deletes any existing
+    # settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -1211,7 +1220,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Deletes the APNs channel for an app.
+    # Disables the APNs channel for an application and deletes any existing
+    # settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -1249,7 +1259,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Delete an APNS sandbox channel.
+    # Disables the APNs sandbox channel for an application and deletes any
+    # existing settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -1287,7 +1298,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Delete an APNS VoIP channel
+    # Disables the APNs VoIP channel for an application and deletes any
+    # existing settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -1325,7 +1337,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Delete an APNS VoIP sandbox channel
+    # Disables the APNs VoIP sandbox channel for an application and deletes
+    # any existing settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -1363,7 +1376,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Deletes an app.
+    # Deletes an application.
     #
     # @option params [required, String] :application_id
     #
@@ -1394,7 +1407,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Delete a BAIDU GCM channel
+    # Disables the Baidu channel for an application and deletes any existing
+    # settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -1431,7 +1445,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Deletes a campaign.
+    # Deletes a campaign from an application.
     #
     # @option params [required, String] :application_id
     #
@@ -1661,7 +1675,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Delete an email channel.
+    # Disables the email channel for an application and deletes any existing
+    # settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -1702,7 +1717,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Deletes an endpoint.
+    # Deletes an endpoint from an application.
     #
     # @option params [required, String] :application_id
     #
@@ -1764,7 +1779,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Deletes the event stream for an app.
+    # Deletes the event stream for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -1796,7 +1811,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Deletes the GCM channel for an app.
+    # Disables the GCM channel for an application and deletes any existing
+    # settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -1833,7 +1849,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Deletes a segment.
+    # Deletes a segment from an application.
     #
     # @option params [required, String] :application_id
     #
@@ -1961,7 +1977,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Delete an SMS channel.
+    # Disables the SMS channel for an application and deletes any existing
+    # settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -2001,7 +2018,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Deletes endpoints that are associated with a User ID.
+    # Deletes all the endpoints that are associated with a specific user ID.
     #
     # @option params [required, String] :application_id
     #
@@ -2064,7 +2081,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Delete an Voice channel
+    # Disables the voice channel for an application and deletes any existing
+    # settings for the channel.
     #
     # @option params [required, String] :application_id
     #
@@ -2100,7 +2118,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get an ADM channel.
+    # Retrieves information about the status and settings of the ADM channel
+    # for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -2136,7 +2155,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about the APNs channel for an app.
+    # Retrieves information about the status and settings of the APNs
+    # channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -2174,7 +2194,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get an APNS sandbox channel.
+    # Retrieves information about the status and settings of the APNs
+    # sandbox channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -2212,7 +2233,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get an APNS VoIP channel
+    # Retrieves information about the status and settings of the APNs VoIP
+    # channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -2250,7 +2272,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get an APNS VoIPSandbox channel
+    # Retrieves information about the status and settings of the APNs VoIP
+    # sandbox channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -2288,7 +2311,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about an app.
+    # Retrieves information about an application.
     #
     # @option params [required, String] :application_id
     #
@@ -2319,7 +2342,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Used to request the settings for an app.
+    # Retrieves information about the settings for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -2356,7 +2379,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about your apps.
+    # Retrieves information about all of your applications.
     #
     # @option params [String] :page_size
     #
@@ -2392,7 +2415,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get a BAIDU GCM channel
+    # Retrieves information about the status and settings of the Baidu Cloud
+    # Push channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -2429,7 +2453,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about a campaign.
+    # Retrieves information about the status, configuration, and other
+    # settings for a campaign.
     #
     # @option params [required, String] :application_id
     #
@@ -2659,7 +2684,7 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about the activity performed by a campaign.
+    # Retrieves information about the activity performed by a campaign.
     #
     # @option params [required, String] :application_id
     #
@@ -2709,7 +2734,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about a specific version of a campaign.
+    # Retrieves information about the status, configuration, and other
+    # settings for a specific version of a campaign.
     #
     # @option params [required, String] :application_id
     #
@@ -2942,7 +2968,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about your campaign versions.
+    # Retrieves information about the status, configuration, and other
+    # settings for all versions of a specific campaign.
     #
     # @option params [required, String] :application_id
     #
@@ -3180,7 +3207,9 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about your campaigns.
+    # Retrieves information about the status, configuration, and other
+    # settings for all the campaigns that are associated with an
+    # application.
     #
     # @option params [required, String] :application_id
     #
@@ -3415,7 +3444,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get all channels.
+    # Retrieves information about the history and status of each channel for
+    # an application.
     #
     # @option params [required, String] :application_id
     #
@@ -3451,7 +3481,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get an email channel.
+    # Retrieves information about the status and settings of the email
+    # channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -3492,7 +3523,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about an endpoint.
+    # Retrieves information about the settings and attributes of a specific
+    # endpoint for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -3554,7 +3586,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns the event stream for an app.
+    # Retrieves information about the event stream settings for an
+    # application.
     #
     # @option params [required, String] :application_id
     #
@@ -3586,7 +3619,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about an export job.
+    # Retrieves information about the status and settings of a specific
+    # export job for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -3632,7 +3666,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about your export jobs.
+    # Retrieves information about the status and settings of all the export
+    # jobs for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -3683,7 +3718,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about the GCM channel for an app.
+    # Retrieves information about the status and settings of the GCM channel
+    # for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -3720,7 +3756,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about an import job.
+    # Retrieves information about the status and settings of a specific
+    # import job for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -3770,7 +3807,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about your import jobs.
+    # Retrieves information about the status and settings of all the import
+    # jobs for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -3825,7 +3863,9 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about a segment.
+    # Retrieves information about the configuration, dimension, and other
+    # settings for a specific segment that's associated with an
+    # application.
     #
     # @option params [required, String] :application_id
     #
@@ -3953,7 +3993,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns a list of export jobs for a specific segment.
+    # Retrieves information about the status and settings of the export jobs
+    # for a segment.
     #
     # @option params [required, String] :application_id
     #
@@ -4007,7 +4048,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns a list of import jobs for a specific segment.
+    # Retrieves information about the status and settings of the import jobs
+    # for a segment.
     #
     # @option params [required, String] :application_id
     #
@@ -4065,7 +4107,9 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about a segment version.
+    # Retrieves information about the configuration, dimension, and other
+    # settings for a specific version of a segment that's associated with
+    # an application.
     #
     # @option params [required, String] :application_id
     #
@@ -4196,7 +4240,9 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about your segment versions.
+    # Retrieves information about the configuration, dimension, and other
+    # settings for all versions of a specific segment that's associated
+    # with an application.
     #
     # @option params [required, String] :application_id
     #
@@ -4332,7 +4378,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Used to get information about your segments.
+    # Retrieves information about the configuration, dimension, and other
+    # settings for all the segments that are associated with an application.
     #
     # @option params [required, String] :application_id
     #
@@ -4465,7 +4512,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get an SMS channel.
+    # Retrieves information about the status and settings of the SMS channel
+    # for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -4505,8 +4553,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about the endpoints that are associated with a
-    # User ID.
+    # Retrieves information about all the endpoints that are associated with
+    # a specific user ID.
     #
     # @option params [required, String] :application_id
     #
@@ -4569,7 +4617,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get a Voice Channel
+    # Retrieves information about the status and settings of the voice
+    # channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -4605,7 +4654,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Get list of all tags for a given resource arn
+    # Retrieves all the tags (keys and values) that are associated with an
+    # application, campaign, or segment.
     #
     # @option params [required, String] :resource_arn
     #
@@ -4633,10 +4683,10 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Returns information about the specified phone number.
+    # Retrieves information about a phone number.
     #
     # @option params [required, Types::NumberValidateRequest] :number_validate_request
-    #   Phone Number Validate request.
+    #   Specifies a phone number to validate and retrieve information about.
     #
     # @return [Types::PhoneNumberValidateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4677,12 +4727,15 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Use to create or update the event stream for an app.
+    # Creates a new event stream for an application or updates the settings
+    # of an existing event stream for an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::WriteEventStream] :write_event_stream
-    #   Request to save an EventStream.
+    #   Specifies the Amazon Resource Name (ARN) of an event stream to publish
+    #   events to and the AWS Identity and Access Management (IAM) role to use
+    #   when publishing those events.
     #
     # @return [Types::PutEventStreamResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4693,8 +4746,8 @@ module Aws::Pinpoint
     #   resp = client.put_event_stream({
     #     application_id: "__string", # required
     #     write_event_stream: { # required
-    #       destination_stream_arn: "__string",
-    #       role_arn: "__string",
+    #       destination_stream_arn: "__string", # required
+    #       role_arn: "__string", # required
     #     },
     #   })
     #
@@ -4716,14 +4769,13 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Use to record events for endpoints. This method creates events and
-    # creates or updates the endpoints that those events are associated
-    # with.
+    # Creates a new event to record for endpoints, or creates or updates
+    # endpoint data that existing events are associated with.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::EventsRequest] :events_request
-    #   A set of events to process.
+    #   Specifies a batch of events to process.
     #
     # @return [Types::PutEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4734,9 +4786,9 @@ module Aws::Pinpoint
     #   resp = client.put_events({
     #     application_id: "__string", # required
     #     events_request: { # required
-    #       batch_item: {
+    #       batch_item: { # required
     #         "__string" => {
-    #           endpoint: {
+    #           endpoint: { # required
     #             address: "__string",
     #             attributes: {
     #               "__string" => ["__string"],
@@ -4774,7 +4826,7 @@ module Aws::Pinpoint
     #               user_id: "__string",
     #             },
     #           },
-    #           events: {
+    #           events: { # required
     #             "__string" => {
     #               app_package_name: "__string",
     #               app_title: "__string",
@@ -4783,18 +4835,18 @@ module Aws::Pinpoint
     #                 "__string" => "__string",
     #               },
     #               client_sdk_version: "__string",
-    #               event_type: "__string",
+    #               event_type: "__string", # required
     #               metrics: {
     #                 "__string" => 1.0,
     #               },
     #               sdk_name: "__string",
     #               session: {
     #                 duration: 1,
-    #                 id: "__string",
-    #                 start_timestamp: "__string",
+    #                 id: "__string", # required
+    #                 start_timestamp: "__string", # required
     #                 stop_timestamp: "__string",
     #               },
-    #               timestamp: "__string",
+    #               timestamp: "__string", # required
     #             },
     #           },
     #         },
@@ -4820,14 +4872,16 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Used to remove the attributes for an app
+    # Removes one or more attributes, of the same attribute type, from all
+    # the endpoints that are associated with an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, String] :attribute_type
     #
     # @option params [required, Types::UpdateAttributesRequest] :update_attributes_request
-    #   Update attributes request
+    #   Specifies one or more attributes to remove from all the endpoints that
+    #   are associated with an application.
     #
     # @return [Types::RemoveAttributesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4859,12 +4913,13 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Used to send a direct message.
+    # Creates and sends a direct message.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::MessageRequest] :message_request
-    #   Send message request.
+    #   Specifies the objects that define configuration and other settings for
+    #   a message.
     #
     # @return [Types::SendMessagesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4905,7 +4960,7 @@ module Aws::Pinpoint
     #           title_override: "__string",
     #         },
     #       },
-    #       message_configuration: {
+    #       message_configuration: { # required
     #         adm_message: {
     #           action: "OPEN_APP", # accepts OPEN_APP, DEEP_LINK, URL
     #           body: "__string",
@@ -5090,12 +5145,13 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Used to send a message to a list of users.
+    # Creates and sends a message to a list of users.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::SendUsersMessageRequest] :send_users_message_request
-    #   Send message request.
+    #   Specifies the configuration and other settings for a message to send
+    #   to all the endpoints that are associated with a list of users.
     #
     # @return [Types::SendUsersMessagesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5109,7 +5165,7 @@ module Aws::Pinpoint
     #       context: {
     #         "__string" => "__string",
     #       },
-    #       message_configuration: {
+    #       message_configuration: { # required
     #         adm_message: {
     #           action: "OPEN_APP", # accepts OPEN_APP, DEEP_LINK, URL
     #           body: "__string",
@@ -5264,7 +5320,7 @@ module Aws::Pinpoint
     #         },
     #       },
     #       trace_id: "__string",
-    #       users: {
+    #       users: { # required
     #         "__string" => {
     #           body_override: "__string",
     #           context: {
@@ -5302,11 +5358,14 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Adds tags to a resource.
+    # Adds one or more tags (keys and values) to an application, campaign,
+    # or segment.
     #
     # @option params [required, String] :resource_arn
     #
     # @option params [required, Types::TagsModel] :tags_model
+    #   Specifies the tags (keys and values) for an application, campaign, or
+    #   segment.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5330,7 +5389,8 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Remove tags from a resource.
+    # Removes one or more tags (keys and values) from an application,
+    # campaign, or segment.
     #
     # @option params [required, String] :resource_arn
     #
@@ -5354,10 +5414,11 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Update an ADM channel.
+    # Updates the ADM channel settings for an application.
     #
     # @option params [required, Types::ADMChannelRequest] :adm_channel_request
-    #   Amazon Device Messaging channel definition.
+    #   Specifies the status and settings of the ADM (Amazon Device Messaging)
+    #   channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -5369,8 +5430,8 @@ module Aws::Pinpoint
     #
     #   resp = client.update_adm_channel({
     #     adm_channel_request: { # required
-    #       client_id: "__string",
-    #       client_secret: "__string",
+    #       client_id: "__string", # required
+    #       client_secret: "__string", # required
     #       enabled: false,
     #     },
     #     application_id: "__string", # required
@@ -5398,10 +5459,11 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Use to update the APNs channel for an app.
+    # Updates the APNs channel settings for an application.
     #
     # @option params [required, Types::APNSChannelRequest] :apns_channel_request
-    #   Apple Push Notification Service channel definition.
+    #   Specifies the status and settings of the APNs (Apple Push Notification
+    #   service) channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -5449,10 +5511,11 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Update an APNS sandbox channel.
+    # Updates the APNs sandbox channel settings for an application.
     #
     # @option params [required, Types::APNSSandboxChannelRequest] :apns_sandbox_channel_request
-    #   Apple Development Push Notification Service channel definition.
+    #   Specifies the status and settings of the APNs (Apple Push Notification
+    #   service) sandbox channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -5500,10 +5563,11 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Update an APNS VoIP channel
+    # Updates the APNs VoIP channel settings for an application.
     #
     # @option params [required, Types::APNSVoipChannelRequest] :apns_voip_channel_request
-    #   Apple VoIP Push Notification Service channel definition.
+    #   Specifies the status and settings of the APNs (Apple Push Notification
+    #   service) VoIP channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -5551,10 +5615,12 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Update an APNS VoIP sandbox channel
+    # Updates the settings for the APNs VoIP sandbox channel for an
+    # application.
     #
     # @option params [required, Types::APNSVoipSandboxChannelRequest] :apns_voip_sandbox_channel_request
-    #   Apple VoIP Developer Push Notification Service channel definition.
+    #   Specifies the status and settings of the APNs (Apple Push Notification
+    #   service) VoIP sandbox channel for an application.
     #
     # @option params [required, String] :application_id
     #
@@ -5602,12 +5668,12 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Used to update the settings for an app.
+    # Updates the settings for an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::WriteApplicationSettingsRequest] :write_application_settings_request
-    #   Creating application setting request
+    #   Specifies the default settings for an application.
     #
     # @return [Types::UpdateApplicationSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5660,12 +5726,13 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Update a BAIDU GCM channel
+    # Updates the settings of the Baidu channel for an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::BaiduChannelRequest] :baidu_channel_request
-    #   Baidu Cloud Push credentials
+    #   Specifies the status and settings of the Baidu (Baidu Cloud Push)
+    #   channel for an application.
     #
     # @return [Types::UpdateBaiduChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5676,9 +5743,9 @@ module Aws::Pinpoint
     #   resp = client.update_baidu_channel({
     #     application_id: "__string", # required
     #     baidu_channel_request: { # required
-    #       api_key: "__string",
+    #       api_key: "__string", # required
     #       enabled: false,
-    #       secret_key: "__string",
+    #       secret_key: "__string", # required
     #     },
     #   })
     #
@@ -5705,14 +5772,14 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Use to update a campaign.
+    # Updates the settings for a campaign.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, String] :campaign_id
     #
     # @option params [required, Types::WriteCampaignRequest] :write_campaign_request
-    #   Used to create a campaign.
+    #   Specifies the configuration and other settings for a campaign.
     #
     # @return [Types::UpdateCampaignResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5787,7 +5854,7 @@ module Aws::Pinpoint
     #               body: "__string",
     #               from_address: "__string",
     #               html_body: "__string",
-    #               title: "__string",
+    #               title: "__string", # required
     #             },
     #             gcm_message: {
     #               action: "OPEN_APP", # accepts OPEN_APP, DEEP_LINK, URL
@@ -5812,25 +5879,25 @@ module Aws::Pinpoint
     #           schedule: {
     #             end_time: "__string",
     #             event_filter: {
-    #               dimensions: {
+    #               dimensions: { # required
     #                 attributes: {
     #                   "__string" => {
     #                     attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                 },
     #                 event_type: {
     #                   dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                   values: ["__string"],
+    #                   values: ["__string"], # required
     #                 },
     #                 metrics: {
     #                   "__string" => {
-    #                     comparison_operator: "__string",
-    #                     value: 1.0,
+    #                     comparison_operator: "__string", # required
+    #                     value: 1.0, # required
     #                   },
     #                 },
     #               },
-    #               filter_type: "SYSTEM", # accepts SYSTEM, ENDPOINT
+    #               filter_type: "SYSTEM", # required, accepts SYSTEM, ENDPOINT
     #             },
     #             frequency: "ONCE", # accepts ONCE, HOURLY, DAILY, WEEKLY, MONTHLY, EVENT
     #             is_local_time: false,
@@ -5838,10 +5905,10 @@ module Aws::Pinpoint
     #               end: "__string",
     #               start: "__string",
     #             },
-    #             start_time: "__string",
+    #             start_time: "__string", # required
     #             timezone: "__string",
     #           },
-    #           size_percent: 1,
+    #           size_percent: 1, # required
     #           treatment_description: "__string",
     #           treatment_name: "__string",
     #         },
@@ -5921,7 +5988,7 @@ module Aws::Pinpoint
     #           body: "__string",
     #           from_address: "__string",
     #           html_body: "__string",
-    #           title: "__string",
+    #           title: "__string", # required
     #         },
     #         gcm_message: {
     #           action: "OPEN_APP", # accepts OPEN_APP, DEEP_LINK, URL
@@ -5947,25 +6014,25 @@ module Aws::Pinpoint
     #       schedule: {
     #         end_time: "__string",
     #         event_filter: {
-    #           dimensions: {
+    #           dimensions: { # required
     #             attributes: {
     #               "__string" => {
     #                 attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                 values: ["__string"],
+    #                 values: ["__string"], # required
     #               },
     #             },
     #             event_type: {
     #               dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #               values: ["__string"],
+    #               values: ["__string"], # required
     #             },
     #             metrics: {
     #               "__string" => {
-    #                 comparison_operator: "__string",
-    #                 value: 1.0,
+    #                 comparison_operator: "__string", # required
+    #                 value: 1.0, # required
     #               },
     #             },
     #           },
-    #           filter_type: "SYSTEM", # accepts SYSTEM, ENDPOINT
+    #           filter_type: "SYSTEM", # required, accepts SYSTEM, ENDPOINT
     #         },
     #         frequency: "ONCE", # accepts ONCE, HOURLY, DAILY, WEEKLY, MONTHLY, EVENT
     #         is_local_time: false,
@@ -5973,7 +6040,7 @@ module Aws::Pinpoint
     #           end: "__string",
     #           start: "__string",
     #         },
-    #         start_time: "__string",
+    #         start_time: "__string", # required
     #         timezone: "__string",
     #       },
     #       segment_id: "__string",
@@ -6199,12 +6266,14 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Update an email channel.
+    # Updates the status and settings of the email channel for an
+    # application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::EmailChannelRequest] :email_channel_request
-    #   Email Channel Request
+    #   Specifies the status and settings of the email channel for an
+    #   application.
     #
     # @return [Types::UpdateEmailChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6217,8 +6286,8 @@ module Aws::Pinpoint
     #     email_channel_request: { # required
     #       configuration_set: "__string",
     #       enabled: false,
-    #       from_address: "__string",
-    #       identity: "__string",
+    #       from_address: "__string", # required
+    #       identity: "__string", # required
     #       role_arn: "__string",
     #     },
     #   })
@@ -6250,14 +6319,17 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Creates or updates an endpoint.
+    # Creates a new endpoint for an application or updates the settings and
+    # attributes of an existing endpoint for an application. You can also
+    # use this operation to define custom attributes (Attributes, Metrics,
+    # and UserAttributes properties) for an endpoint.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, String] :endpoint_id
     #
     # @option params [required, Types::EndpointRequest] :endpoint_request
-    #   An endpoint update request.
+    #   Specifies the channel type and other settings for an endpoint.
     #
     # @return [Types::UpdateEndpointResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6322,12 +6394,17 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Use to update a batch of endpoints.
+    # Creates a new batch of endpoints for an application or updates the
+    # settings and attributes of a batch of existing endpoints for an
+    # application. You can also use this operation to define custom
+    # attributes (Attributes, Metrics, and UserAttributes properties) for a
+    # batch of endpoints.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::EndpointBatchRequest] :endpoint_batch_request
-    #   Endpoint batch update request.
+    #   Specifies a batch of endpoints to create or update and the settings
+    #   and attributes to set or change for each endpoint.
     #
     # @return [Types::UpdateEndpointsBatchResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6338,7 +6415,7 @@ module Aws::Pinpoint
     #   resp = client.update_endpoints_batch({
     #     application_id: "__string", # required
     #     endpoint_batch_request: { # required
-    #       item: [
+    #       item: [ # required
     #         {
     #           address: "__string",
     #           attributes: {
@@ -6396,12 +6473,15 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Use to update the GCM channel for an app.
+    # Updates the status and settings of the GCM channel for an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::GCMChannelRequest] :gcm_channel_request
-    #   Google Cloud Messaging credentials
+    #   Specifies the status and settings of the GCM channel for an
+    #   application. This channel enables Amazon Pinpoint to send push
+    #   notifications through the Firebase Cloud Messaging (FCM), formerly
+    #   Google Cloud Messaging (GCM), service.
     #
     # @return [Types::UpdateGcmChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6412,7 +6492,7 @@ module Aws::Pinpoint
     #   resp = client.update_gcm_channel({
     #     application_id: "__string", # required
     #     gcm_channel_request: { # required
-    #       api_key: "__string",
+    #       api_key: "__string", # required
     #       enabled: false,
     #     },
     #   })
@@ -6440,14 +6520,18 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Used to update a segment.
+    # Creates a new segment for an application or updates the configuration,
+    # dimension, and other settings for an existing segment that's
+    # associated with an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, String] :segment_id
     #
     # @option params [required, Types::WriteSegmentRequest] :write_segment_request
-    #   Segment definition.
+    #   Specifies the configuration, dimension, and other settings for a
+    #   segment. A WriteSegmentRequest object can include a Dimensions object
+    #   or a SegmentGroups object, but not both.
     #
     # @return [Types::UpdateSegmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6463,64 +6547,64 @@ module Aws::Pinpoint
     #         attributes: {
     #           "__string" => {
     #             attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #         },
     #         behavior: {
     #           recency: {
-    #             duration: "HR_24", # accepts HR_24, DAY_7, DAY_14, DAY_30
-    #             recency_type: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #             duration: "HR_24", # required, accepts HR_24, DAY_7, DAY_14, DAY_30
+    #             recency_type: "ACTIVE", # required, accepts ACTIVE, INACTIVE
     #           },
     #         },
     #         demographic: {
     #           app_version: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           channel: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           device_type: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           make: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           model: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           platform: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #         },
     #         location: {
     #           country: {
     #             dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #           gps_point: {
-    #             coordinates: {
-    #               latitude: 1.0,
-    #               longitude: 1.0,
+    #             coordinates: { # required
+    #               latitude: 1.0, # required
+    #               longitude: 1.0, # required
     #             },
     #             range_in_kilometers: 1.0,
     #           },
     #         },
     #         metrics: {
     #           "__string" => {
-    #             comparison_operator: "__string",
-    #             value: 1.0,
+    #             comparison_operator: "__string", # required
+    #             value: 1.0, # required
     #           },
     #         },
     #         user_attributes: {
     #           "__string" => {
     #             attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #             values: ["__string"],
+    #             values: ["__string"], # required
     #           },
     #         },
     #       },
@@ -6533,71 +6617,71 @@ module Aws::Pinpoint
     #                 attributes: {
     #                   "__string" => {
     #                     attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                 },
     #                 behavior: {
     #                   recency: {
-    #                     duration: "HR_24", # accepts HR_24, DAY_7, DAY_14, DAY_30
-    #                     recency_type: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #                     duration: "HR_24", # required, accepts HR_24, DAY_7, DAY_14, DAY_30
+    #                     recency_type: "ACTIVE", # required, accepts ACTIVE, INACTIVE
     #                   },
     #                 },
     #                 demographic: {
     #                   app_version: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   channel: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   device_type: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   make: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   model: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   platform: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                 },
     #                 location: {
     #                   country: {
     #                     dimension_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                   gps_point: {
-    #                     coordinates: {
-    #                       latitude: 1.0,
-    #                       longitude: 1.0,
+    #                     coordinates: { # required
+    #                       latitude: 1.0, # required
+    #                       longitude: 1.0, # required
     #                     },
     #                     range_in_kilometers: 1.0,
     #                   },
     #                 },
     #                 metrics: {
     #                   "__string" => {
-    #                     comparison_operator: "__string",
-    #                     value: 1.0,
+    #                     comparison_operator: "__string", # required
+    #                     value: 1.0, # required
     #                   },
     #                 },
     #                 user_attributes: {
     #                   "__string" => {
     #                     attribute_type: "INCLUSIVE", # accepts INCLUSIVE, EXCLUSIVE
-    #                     values: ["__string"],
+    #                     values: ["__string"], # required
     #                   },
     #                 },
     #               },
     #             ],
     #             source_segments: [
     #               {
-    #                 id: "__string",
+    #                 id: "__string", # required
     #                 version: 1,
     #               },
     #             ],
@@ -6724,12 +6808,13 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Update an SMS channel.
+    # Updates the status and settings of the SMS channel for an application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::SMSChannelRequest] :sms_channel_request
-    #   SMS Channel Request
+    #   Specifies the status and settings of the SMS channel for an
+    #   application.
     #
     # @return [Types::UpdateSmsChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6772,12 +6857,14 @@ module Aws::Pinpoint
       req.send_request(options)
     end
 
-    # Update an Voice channel
+    # Updates the status and settings of the voice channel for an
+    # application.
     #
     # @option params [required, String] :application_id
     #
     # @option params [required, Types::VoiceChannelRequest] :voice_channel_request
-    #   Voice Channel Request
+    #   Specifies the status and settings of the voice channel for an
+    #   application.
     #
     # @return [Types::UpdateVoiceChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6827,7 +6914,7 @@ module Aws::Pinpoint
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-pinpoint'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.24.0'
       Seahorse::Client::Request.new(handlers, context)
     end