{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"requestBodies":{},"responses":{},"schemas":{"DspBadRequestExceptionResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubError"},"maxItems":100,"minItems":1,"type":"array"},"requestId":{"type":"string"}},"type":"object"},"DspConflictExceptionResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubError"},"maxItems":100,"minItems":1,"type":"array"},"requestId":{"type":"string"}},"type":"object"},"DspForbiddenExceptionResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubError"},"maxItems":100,"minItems":1,"type":"array"},"requestId":{"type":"string"}},"type":"object"},"DspInternalServerExceptionResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubError"},"maxItems":100,"minItems":1,"type":"array"},"requestId":{"type":"string"}},"type":"object"},"DspListThirdPartyTargetSegmentsRequestContent":{"properties":{"maxResults":{"description":"Sets the maximum number of results in the returned array. Use in conjunction with the nextToken parameter to control pagination. For example, supplying maxResults\u003d20 with a previously returned token will fetch up to the next 20 items. In some cases, fewer items may be returned. ``Default: 25``.","maximum":1000,"minimum":1,"type":"integer"},"nextToken":{"description":"Operations that return paginated results include a pagination token in this field. To retrieve the next page of results, call the same operation and specify this token in the request. If the nextToken field is empty, there are no further results.","type":"string"},"thirdPartyTargetTypeFilter":{"description":"Third-party target type filter.","items":{"$ref":"#/components/schemas/ThirdPartyTargetTypes"},"maxItems":10,"minItems":1,"type":"array","uniqueItems":true}},"required":["thirdPartyTargetTypeFilter"],"type":"object"},"DspListThirdPartyTargetSegmentsResponseContent":{"properties":{"nextToken":{"description":"Token from a previous request. Use in conjunction with the ``maxResults`` parameter to control pagination of the returned array.","type":"string"},"thirdPartyTargetSegments":{"description":"List of segments associated to given thirdPartyTargetType","items":{"$ref":"#/components/schemas/DspThirdPartyTargetSegmentsInfo"},"maxItems":1000,"minItems":0,"type":"array"}},"required":["thirdPartyTargetSegments"],"type":"object"},"DspNotFoundExceptionResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubError"},"maxItems":100,"minItems":1,"type":"array"},"requestId":{"type":"string"}},"type":"object"},"DspSubError":{"properties":{"errorCode":{"type":"string"},"errorId":{"type":"string"},"errorMessage":{"type":"string"}},"required":["errorCode","errorMessage"],"type":"object"},"DspThirdPartyTargetSegmentsInfo":{"properties":{"segmentDescription":{"description":"The segment description.","type":"string"},"segmentId":{"description":"The segment identifier.","type":"string"},"segmentName":{"description":"The segment name.","type":"string"},"thirdPartyTargetType":{"$ref":"#/components/schemas/ThirdPartyTargetTypes"}},"required":["thirdPartyTargetType"],"type":"object"},"DspTooManyRequestsExceptionResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubError"},"maxItems":100,"minItems":1,"type":"array"},"requestId":{"type":"string"}},"type":"object"},"DspUnauthorizedExceptionResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubError"},"maxItems":100,"minItems":1,"type":"array"},"requestId":{"type":"string"}},"type":"object"},"DspUnsupportedMediaTypeExceptionResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubError"},"maxItems":100,"minItems":1,"type":"array"},"requestId":{"type":"string"}},"type":"object"},"ThirdPartyTargetTypes":{"enum":["DOUBLE_VERIFY_CUSTOM_CONTEXTUAL"],"type":"string"}},"securitySchemes":{}},"info":{"description":"Retrieves a list of third-party targeting segments for the given target type filter. If no data is present for the given input, an empty segment list will be returned.","title":"Discovery - Third-party Target Segments - V1","version":"3.0"},"openapi":"3.0.1","paths":{"/dsp/v1/thirdPartyTargetSegments/list":{"post":{"description":"Retrieves a list of third-party targeting segments for the given target type filter. If no data is present for the given input, an empty segment list will be returned.\n\n**Requires one of these permissions**:\n[]","operationId":"DspListDiscoveryThirdPartyTargetSegmentsV1","parameters":[{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","in":"header","name":"Amazon-Ads-AccountId","required":true,"schema":{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspListThirdPartyTargetSegmentsRequestContent"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspListThirdPartyTargetSegmentsResponseContent"}}},"description":"Successful operation."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspBadRequestExceptionResponseContent"}}},"description":"Bad Request or request body is not matching with input model."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnauthorizedExceptionResponseContent"}}},"description":"Unauthenticated request."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspForbiddenExceptionResponseContent"}}},"description":"Forbidden - Request failed because user is not authorized to access a resource."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspNotFoundExceptionResponseContent"}}},"description":"Not Found - Requested resource does not exist or is not visible for the authenticated user."},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspConflictExceptionResponseContent"}}},"description":"Conflict detected. A change has been made to the line items data since these draft changes were started. Create a new draft set and retry the commit with the new set."},"415":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnsupportedMediaTypeExceptionResponseContent"}}},"description":"Unsupported Media Type - Version not supported."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspTooManyRequestsExceptionResponseContent"}}},"description":"Too Many Requests - Request was rate-limited. Retry later."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspInternalServerExceptionResponseContent"}}},"description":"Internal Server Error."}},"tags":["Discovery - Third-party Target Segments"]}}}}