Struct sendgrid_api::segmenting_contacts::SegmentingContacts [−][src]
pub struct SegmentingContacts {
pub client: Client,
}Fields
client: ClientImplementations
pub async fn get_marketing_segments(
&self,
parent_list_ids: &str,
no_parent_list_id: bool
) -> Result<GetMarketingSegmentsResponse>
pub async fn get_marketing_segments(
&self,
parent_list_ids: &str,
no_parent_list_id: bool
) -> Result<GetMarketingSegmentsResponse>
Get List of Segments.
This function performs a GET to the /marketing/segments endpoint.
This endpoint allows you to retrieve a list of segments.
The query param parent_list_ids is treated as a filter. Any match will be returned. 0 matches will return a response code of 200 with an empty results array.
parent_list_ids | no_parent_list_id | result |
|---|---|---|
| empty | false | all segments |
| values | false | segments filtered by list_ids |
| values | true | segments filtered by list_ids and segments with no parent list_ids |
| empty | true | segments with no parent list_ids |
Parameters:
parent_list_ids: &str– A comma separated list of list ids to be used when searching for segments with the specified parent_list_id, no more than 50 is allowed.no_parent_list_id: bool– If set totruesegments with an empty value ofparent_list_idwill be returned in the filter. If the value is not present it defaults to ‘false’.
pub async fn post_marketing_segment(
&self,
body: &PostMarketingSegmentsRequestAllOf
) -> Result<FullSegmentAllOf>
pub async fn post_marketing_segment(
&self,
body: &PostMarketingSegmentsRequestAllOf
) -> Result<FullSegmentAllOf>
Create Segment.
This function performs a POST to the /marketing/segments endpoint.
This endpoint allows you to create a segment.
pub async fn get_marketing_segments_segment(
&self,
segment_id: Uuid,
query_json: bool
) -> Result<FullSegmentAllOf>
pub async fn get_marketing_segments_segment(
&self,
segment_id: Uuid,
query_json: bool
) -> Result<FullSegmentAllOf>
Get Segment by ID.
This function performs a GET to the /marketing/segments/{segment_id} endpoint.
This endpoint allows you to retrieve a single segment by ID.
Parameters:
query_json: bool– Defaults tofalse. Set totrueto return the parsed SQL AST as a JSON object in the fieldquery_json.
Delete Segment.
This function performs a DELETE to the /marketing/segments/{segment_id} endpoint.
This endpoint allows you to delete a segment by segment_id.
Note that deleting a segment does not delete the contacts associated with the segment by default. Contacts associated with a deleted segment will remain in your list of all contacts and any other segments they belong to.
pub async fn patch_marketing_segments_segment(
&self,
segment_id: Uuid,
body: &SegmentWriteV2
) -> Result<FullSegmentAllOf>
pub async fn patch_marketing_segments_segment(
&self,
segment_id: Uuid,
body: &SegmentWriteV2
) -> Result<FullSegmentAllOf>
Update Segment.
This function performs a PATCH to the /marketing/segments/{segment_id} endpoint.
This endpoint allows you to update a segment.
Segment name needs to be unique. A user can not update a segment name to an existing one.
pub async fn post_marketing_segments_delete(
&self,
body: &PostMarketingSegmentsDeleteRequest
) -> Result<PostMarketingSegmentsDeleteResponse>
pub async fn post_marketing_segments_delete(
&self,
body: &PostMarketingSegmentsDeleteRequest
) -> Result<PostMarketingSegmentsDeleteResponse>
Bulk Delete Segments.
This function performs a POST to the /marketing/segments/delete endpoint.
This endpoint allows you to delete segments in bulk.
If the segments are used by automations or the segments do not exist in the database, the segment IDs that could not be deleted along with automation IDs that are associated to those segments will be returned.