list method

Future<CreativeFieldValuesListResponse> list(
  1. String profileId,
  2. String creativeFieldId, {
  3. List<String>? ids,
  4. int? maxResults,
  5. String? pageToken,
  6. String? searchString,
  7. String? sortField,
  8. String? sortOrder,
  9. String? $fields,
})

Retrieves a list of creative field values, possibly filtered.

This method supports paging.

Request parameters:

profileId - User profile ID associated with this request. Value must have pattern ^\[^/\]+$.

creativeFieldId - Creative field ID for this creative field value. Value must have pattern ^\[^/\]+$.

ids - Select only creative field values with these IDs.

maxResults - Maximum number of results to return.

pageToken - Value of the nextPageToken from the previous result page.

searchString - Allows searching for creative field values by their values. Wildcards (e.g. *) are not allowed.

sortField - Field by which to sort the list. Possible string values are:

  • "ID"
  • "VALUE"

sortOrder - Order of sorted results. Possible string values are:

  • "ASCENDING" : Ascending order.
  • "DESCENDING" : Descending order.

$fields - Selector specifying which fields to include in a partial response.

Completes with a CreativeFieldValuesListResponse.

Completes with a commons.ApiRequestError if the API endpoint returned an error.

If the used http.Client completes with an error when making a REST call, this method will complete with the same error.

Implementation

async.Future<CreativeFieldValuesListResponse> list(
  core.String profileId,
  core.String creativeFieldId, {
  core.List<core.String>? ids,
  core.int? maxResults,
  core.String? pageToken,
  core.String? searchString,
  core.String? sortField,
  core.String? sortOrder,
  core.String? $fields,
}) async {
  final queryParams_ = <core.String, core.List<core.String>>{
    if (ids != null) 'ids': ids,
    if (maxResults != null) 'maxResults': ['${maxResults}'],
    if (pageToken != null) 'pageToken': [pageToken],
    if (searchString != null) 'searchString': [searchString],
    if (sortField != null) 'sortField': [sortField],
    if (sortOrder != null) 'sortOrder': [sortOrder],
    if ($fields != null) 'fields': [$fields],
  };

  final url_ = 'userprofiles/' +
      core.Uri.encodeFull('$profileId') +
      '/creativeFields/' +
      core.Uri.encodeFull('$creativeFieldId') +
      '/creativeFieldValues';

  final response_ = await _requester.request(
    url_,
    'GET',
    queryParams: queryParams_,
  );
  return CreativeFieldValuesListResponse.fromJson(
      response_ as core.Map<core.String, core.dynamic>);
}