Interface PartnerCentralMarketingAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient

@Generated("software.amazon.awssdk:codegen") @SdkPublicApi @ThreadSafe public interface PartnerCentralMarketingAsyncClient extends AwsClient
Service client for accessing Partner Central Marketing API asynchronously. This can be created using the static builder() method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API call.

AWS Partner Central Marketing API for campaign and asset management.

  • Field Details

  • Method Details

    • batchCreateCampaignAsset

      default CompletableFuture<BatchCreateCampaignAssetResponse> batchCreateCampaignAsset(BatchCreateCampaignAssetRequest batchCreateCampaignAssetRequest)

      Instantiates one or more of the campaign template's blueprints as assets of this campaign.

      The only asset-create operation: DG-038 deleted the singular CreateCampaignAsset, and AWS Batch Operations makes exposing a singular alongside a batch optional ("which MAY actually be exposed in addition"). It also replaced kit instantiation -- CreateCampaign creates zero assets, so this is the only path by which an asset comes into existence.

      Errors here are whole-request only, and nothing is written when one is thrown. Per-entry failures ride in the response's Errors list with a 200. ServiceQuotaExceededException is deliberately absent: a campaign holds at most one asset per blueprint (I-15), so the ceiling is the size of the bound kit and a request of unique valid entries cannot exceed it.

      Parameters:
      batchCreateCampaignAssetRequest - Input for BatchCreateCampaignAsset operation.

      DG-038: replaces CreateCampaignAssetRequest. Selecting assets is a set decision -- a partner picks which of the bound campaign template's blueprints this campaign will carry -- so the operation takes a list of entries and there is no singular create. "Add the blueprint I skipped" is a batch of one.

      Returns:
      A Java Future containing the result of the BatchCreateCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • batchCreateCampaignAsset

      default CompletableFuture<BatchCreateCampaignAssetResponse> batchCreateCampaignAsset(Consumer<BatchCreateCampaignAssetRequest.Builder> batchCreateCampaignAssetRequest)

      Instantiates one or more of the campaign template's blueprints as assets of this campaign.

      The only asset-create operation: DG-038 deleted the singular CreateCampaignAsset, and AWS Batch Operations makes exposing a singular alongside a batch optional ("which MAY actually be exposed in addition"). It also replaced kit instantiation -- CreateCampaign creates zero assets, so this is the only path by which an asset comes into existence.

      Errors here are whole-request only, and nothing is written when one is thrown. Per-entry failures ride in the response's Errors list with a 200. ServiceQuotaExceededException is deliberately absent: a campaign holds at most one asset per blueprint (I-15), so the ceiling is the size of the bound kit and a request of unique valid entries cannot exceed it.


      This is a convenience which creates an instance of the BatchCreateCampaignAssetRequest.Builder avoiding the need to create one manually via BatchCreateCampaignAssetRequest.builder()

      Parameters:
      batchCreateCampaignAssetRequest - A Consumer that will call methods on BatchCreateCampaignAssetRequest.Builder to create a request. Input for BatchCreateCampaignAsset operation.

      DG-038: replaces CreateCampaignAssetRequest. Selecting assets is a set decision -- a partner picks which of the bound campaign template's blueprints this campaign will carry -- so the operation takes a list of entries and there is no singular create. "Add the blueprint I skipped" is a batch of one.

      Returns:
      A Java Future containing the result of the BatchCreateCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createCampaign

      default CompletableFuture<CreateCampaignResponse> createCampaign(CreateCampaignRequest createCampaignRequest)

      Creates a new marketing campaign.

      Returns the identity of the new campaign, not the campaign. Growing a response is backward compatible and shrinking one is not, and the caller's next step is a GetCampaign anyway — a write that supplies an audience cannot report its scan verdict, because that is decided after it commits.

      Parameters:
      createCampaignRequest - Input for CreateCampaign operation.
      Returns:
      A Java Future containing the result of the CreateCampaign operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ServiceQuotaExceededException The request exceeds a service quota.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createCampaign

      default CompletableFuture<CreateCampaignResponse> createCampaign(Consumer<CreateCampaignRequest.Builder> createCampaignRequest)

      Creates a new marketing campaign.

      Returns the identity of the new campaign, not the campaign. Growing a response is backward compatible and shrinking one is not, and the caller's next step is a GetCampaign anyway — a write that supplies an audience cannot report its scan verdict, because that is decided after it commits.


      This is a convenience which creates an instance of the CreateCampaignRequest.Builder avoiding the need to create one manually via CreateCampaignRequest.builder()

      Parameters:
      createCampaignRequest - A Consumer that will call methods on CreateCampaignRequest.Builder to create a request. Input for CreateCampaign operation.
      Returns:
      A Java Future containing the result of the CreateCampaign operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ServiceQuotaExceededException The request exceeds a service quota.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createSocialConnectionAuthorizationUrl

      default CompletableFuture<CreateSocialConnectionAuthorizationUrlResponse> createSocialConnectionAuthorizationUrl(CreateSocialConnectionAuthorizationUrlRequest createSocialConnectionAuthorizationUrlRequest)

      Creates a single-use URL the partner visits to authorize publishing on a platform. Serves a first connect, connecting a further account, and re-authorizing an expired one: consenting with an account that is already connected re-authorizes that connection and keeps its id; any other account adds a connection. Poll ListSocialConnections for the outcome. Deliberately not idempotent and takes no client token: every call must mint a fresh single-use URL, so replaying a cached response would hand back a dead one.

      Parameters:
      createSocialConnectionAuthorizationUrlRequest - Input for CreateSocialConnectionAuthorizationUrl.

      Names a platform, not a connection: the same call serves a first connect, connecting another account, and re-authorizing an expired one. Which of those it was is decided by the account the partner consents with, and shows up in ListSocialConnections afterwards. Writes nothing in this service.

      Returns:
      A Java Future containing the result of the CreateSocialConnectionAuthorizationUrl operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createSocialConnectionAuthorizationUrl

      default CompletableFuture<CreateSocialConnectionAuthorizationUrlResponse> createSocialConnectionAuthorizationUrl(Consumer<CreateSocialConnectionAuthorizationUrlRequest.Builder> createSocialConnectionAuthorizationUrlRequest)

      Creates a single-use URL the partner visits to authorize publishing on a platform. Serves a first connect, connecting a further account, and re-authorizing an expired one: consenting with an account that is already connected re-authorizes that connection and keeps its id; any other account adds a connection. Poll ListSocialConnections for the outcome. Deliberately not idempotent and takes no client token: every call must mint a fresh single-use URL, so replaying a cached response would hand back a dead one.


      This is a convenience which creates an instance of the CreateSocialConnectionAuthorizationUrlRequest.Builder avoiding the need to create one manually via CreateSocialConnectionAuthorizationUrlRequest.builder()

      Parameters:
      createSocialConnectionAuthorizationUrlRequest - A Consumer that will call methods on CreateSocialConnectionAuthorizationUrlRequest.Builder to create a request. Input for CreateSocialConnectionAuthorizationUrl.

      Names a platform, not a connection: the same call serves a first connect, connecting another account, and re-authorizing an expired one. Which of those it was is decided by the account the partner consents with, and shows up in ListSocialConnections afterwards. Writes nothing in this service.

      Returns:
      A Java Future containing the result of the CreateSocialConnectionAuthorizationUrl operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deactivateCampaignAsset

      default CompletableFuture<DeactivateCampaignAssetResponse> deactivateCampaignAsset(DeactivateCampaignAssetRequest deactivateCampaignAssetRequest)

      Stops a live campaign asset: an email's scheduled send is withdrawn, a social post is removed before it publishes. On a completed campaign, it also removes a published document, banner or landing page.

      Synchronous, and safe to repeat. Does not delete the asset record, so a stopped email or social post can be started again.

      Not every asset can be stopped, and the reasons differ in kind. An email that has begun sending cannot be recalled: the send is gone. A document, a banner or a landing page is refused with ASSET_NOT_DEACTIVATABLE until the campaign has completed (the UTC date is after its EndOn). Until then the partner fixes one in place by updating it and activating it again, which keeps its URL, so every email that already linked to it keeps working.

      Once the campaign has completed, the removal is permanent, because a completed campaign can't activate anything again:

      • A document's published PDF is deleted. Its URL stops serving within about a minute (the CDN revalidates), and PublicUrl is no longer returned. Anything that linked to it, such as a landing page's download button or a sent email, reaches an error page. The export still contains the document.
      • A banner's or landing page's published object is taken down at the delivery platform, and the images the partner put on it are deleted. A landing page stops capturing leads, and its PublicUrl is no longer returned. A partner site that embedded a banner shows nothing there. The platform's own CDN can keep serving a copy a visitor already cached, which collects nothing.

      A landing page and a document it links to can be removed in either order.

      Parameters:
      deactivateCampaignAssetRequest - Input for DeactivateCampaignAsset.
      Returns:
      A Java Future containing the result of the DeactivateCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deactivateCampaignAsset

      default CompletableFuture<DeactivateCampaignAssetResponse> deactivateCampaignAsset(Consumer<DeactivateCampaignAssetRequest.Builder> deactivateCampaignAssetRequest)

      Stops a live campaign asset: an email's scheduled send is withdrawn, a social post is removed before it publishes. On a completed campaign, it also removes a published document, banner or landing page.

      Synchronous, and safe to repeat. Does not delete the asset record, so a stopped email or social post can be started again.

      Not every asset can be stopped, and the reasons differ in kind. An email that has begun sending cannot be recalled: the send is gone. A document, a banner or a landing page is refused with ASSET_NOT_DEACTIVATABLE until the campaign has completed (the UTC date is after its EndOn). Until then the partner fixes one in place by updating it and activating it again, which keeps its URL, so every email that already linked to it keeps working.

      Once the campaign has completed, the removal is permanent, because a completed campaign can't activate anything again:

      • A document's published PDF is deleted. Its URL stops serving within about a minute (the CDN revalidates), and PublicUrl is no longer returned. Anything that linked to it, such as a landing page's download button or a sent email, reaches an error page. The export still contains the document.
      • A banner's or landing page's published object is taken down at the delivery platform, and the images the partner put on it are deleted. A landing page stops capturing leads, and its PublicUrl is no longer returned. A partner site that embedded a banner shows nothing there. The platform's own CDN can keep serving a copy a visitor already cached, which collects nothing.

      A landing page and a document it links to can be removed in either order.


      This is a convenience which creates an instance of the DeactivateCampaignAssetRequest.Builder avoiding the need to create one manually via DeactivateCampaignAssetRequest.builder()

      Parameters:
      deactivateCampaignAssetRequest - A Consumer that will call methods on DeactivateCampaignAssetRequest.Builder to create a request. Input for DeactivateCampaignAsset.
      Returns:
      A Java Future containing the result of the DeactivateCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteCampaign

      default CompletableFuture<DeleteCampaignResponse> deleteCampaign(DeleteCampaignRequest deleteCampaignRequest)

      Permanently deletes a campaign, its assets and their stored files.

      A hard delete with no undo: the campaign leaves ListCampaigns and every read of it returns ResourceNotFoundException. Its tags are removed with it.

      Refused with ConflictException while the campaign has a live asset (CAMPAIGN_HAS_ACTIVE_ASSETS), because deleting the record would orphan what the delivery platform still serves or sends: deactivate those assets first. Also refused while an activation task is running (CAMPAIGN_ACTIVATION_IN_PROGRESS). A completed campaign can be deleted.

      Idempotent in effect: deleting a campaign that is already gone returns ResourceNotFoundException, and nothing is left behind by a retry.

      Parameters:
      deleteCampaignRequest - Input for DeleteCampaign.
      Returns:
      A Java Future containing the result of the DeleteCampaign operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteCampaign

      default CompletableFuture<DeleteCampaignResponse> deleteCampaign(Consumer<DeleteCampaignRequest.Builder> deleteCampaignRequest)

      Permanently deletes a campaign, its assets and their stored files.

      A hard delete with no undo: the campaign leaves ListCampaigns and every read of it returns ResourceNotFoundException. Its tags are removed with it.

      Refused with ConflictException while the campaign has a live asset (CAMPAIGN_HAS_ACTIVE_ASSETS), because deleting the record would orphan what the delivery platform still serves or sends: deactivate those assets first. Also refused while an activation task is running (CAMPAIGN_ACTIVATION_IN_PROGRESS). A completed campaign can be deleted.

      Idempotent in effect: deleting a campaign that is already gone returns ResourceNotFoundException, and nothing is left behind by a retry.


      This is a convenience which creates an instance of the DeleteCampaignRequest.Builder avoiding the need to create one manually via DeleteCampaignRequest.builder()

      Parameters:
      deleteCampaignRequest - A Consumer that will call methods on DeleteCampaignRequest.Builder to create a request. Input for DeleteCampaign.
      Returns:
      A Java Future containing the result of the DeleteCampaign operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteCampaignAsset

      default CompletableFuture<DeleteCampaignAssetResponse> deleteCampaignAsset(DeleteCampaignAssetRequest deleteCampaignAssetRequest)

      Permanently deletes a campaign asset.

      Parameters:
      deleteCampaignAssetRequest - Input for DeleteCampaignAsset operation.
      Returns:
      A Java Future containing the result of the DeleteCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteCampaignAsset

      default CompletableFuture<DeleteCampaignAssetResponse> deleteCampaignAsset(Consumer<DeleteCampaignAssetRequest.Builder> deleteCampaignAssetRequest)

      Permanently deletes a campaign asset.


      This is a convenience which creates an instance of the DeleteCampaignAssetRequest.Builder avoiding the need to create one manually via DeleteCampaignAssetRequest.builder()

      Parameters:
      deleteCampaignAssetRequest - A Consumer that will call methods on DeleteCampaignAssetRequest.Builder to create a request. Input for DeleteCampaignAsset operation.
      Returns:
      A Java Future containing the result of the DeleteCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteSocialConnection

      default CompletableFuture<DeleteSocialConnectionResponse> deleteSocialConnection(DeleteSocialConnectionRequest deleteSocialConnectionRequest)

      Revokes and deletes one social connection; other connections on the same platform are untouched. Idempotent: deleting an unknown or already-deleted connection succeeds rather than returning a not-found error.

      Parameters:
      deleteSocialConnectionRequest - Input for DeleteSocialConnection.
      Returns:
      A Java Future containing the result of the DeleteSocialConnection operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteSocialConnection

      default CompletableFuture<DeleteSocialConnectionResponse> deleteSocialConnection(Consumer<DeleteSocialConnectionRequest.Builder> deleteSocialConnectionRequest)

      Revokes and deletes one social connection; other connections on the same platform are untouched. Idempotent: deleting an unknown or already-deleted connection succeeds rather than returning a not-found error.


      This is a convenience which creates an instance of the DeleteSocialConnectionRequest.Builder avoiding the need to create one manually via DeleteSocialConnectionRequest.builder()

      Parameters:
      deleteSocialConnectionRequest - A Consumer that will call methods on DeleteSocialConnectionRequest.Builder to create a request. Input for DeleteSocialConnection.
      Returns:
      A Java Future containing the result of the DeleteSocialConnection operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaign

      default CompletableFuture<GetCampaignResponse> getCampaign(GetCampaignRequest getCampaignRequest)

      Retrieves a campaign by its identifier.

      Parameters:
      getCampaignRequest - Input for GetCampaign operation.
      Returns:
      A Java Future containing the result of the GetCampaign operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaign

      default CompletableFuture<GetCampaignResponse> getCampaign(Consumer<GetCampaignRequest.Builder> getCampaignRequest)

      Retrieves a campaign by its identifier.


      This is a convenience which creates an instance of the GetCampaignRequest.Builder avoiding the need to create one manually via GetCampaignRequest.builder()

      Parameters:
      getCampaignRequest - A Consumer that will call methods on GetCampaignRequest.Builder to create a request. Input for GetCampaign operation.
      Returns:
      A Java Future containing the result of the GetCampaign operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaignAsset

      default CompletableFuture<GetCampaignAssetResponse> getCampaignAsset(GetCampaignAssetRequest getCampaignAssetRequest)

      Retrieves an asset by its identifier.

      Parameters:
      getCampaignAssetRequest - Input for GetCampaignAsset operation.
      Returns:
      A Java Future containing the result of the GetCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaignAsset

      default CompletableFuture<GetCampaignAssetResponse> getCampaignAsset(Consumer<GetCampaignAssetRequest.Builder> getCampaignAssetRequest)

      Retrieves an asset by its identifier.


      This is a convenience which creates an instance of the GetCampaignAssetRequest.Builder avoiding the need to create one manually via GetCampaignAssetRequest.builder()

      Parameters:
      getCampaignAssetRequest - A Consumer that will call methods on GetCampaignAssetRequest.Builder to create a request. Input for GetCampaignAsset operation.
      Returns:
      A Java Future containing the result of the GetCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaignAssetActivationTask

      default CompletableFuture<GetCampaignAssetActivationTaskResponse> getCampaignAssetActivationTask(GetCampaignAssetActivationTaskRequest getCampaignAssetActivationTaskRequest)

      Reads a campaign's current activation task.

      Keyed on the campaign, with no task identifier, because a campaign has at most one activation task: runs are serialised, so there is no collection to address into. The caller always holds the task id anyway, because Start returned it — the id is a correlation value, not an address.

      Returns the campaign's most recent task. A new task overwrites the previous one, so this is not a history: the durable per-asset record is on the assets themselves. Returns ResourceNotFoundException when the campaign has never had a task, or when its last one has expired.

      Parameters:
      getCampaignAssetActivationTaskRequest - Input for GetCampaignAssetActivationTask.
      Returns:
      A Java Future containing the result of the GetCampaignAssetActivationTask operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaignAssetActivationTask

      default CompletableFuture<GetCampaignAssetActivationTaskResponse> getCampaignAssetActivationTask(Consumer<GetCampaignAssetActivationTaskRequest.Builder> getCampaignAssetActivationTaskRequest)

      Reads a campaign's current activation task.

      Keyed on the campaign, with no task identifier, because a campaign has at most one activation task: runs are serialised, so there is no collection to address into. The caller always holds the task id anyway, because Start returned it — the id is a correlation value, not an address.

      Returns the campaign's most recent task. A new task overwrites the previous one, so this is not a history: the durable per-asset record is on the assets themselves. Returns ResourceNotFoundException when the campaign has never had a task, or when its last one has expired.


      This is a convenience which creates an instance of the GetCampaignAssetActivationTaskRequest.Builder avoiding the need to create one manually via GetCampaignAssetActivationTaskRequest.builder()

      Parameters:
      getCampaignAssetActivationTaskRequest - A Consumer that will call methods on GetCampaignAssetActivationTaskRequest.Builder to create a request. Input for GetCampaignAssetActivationTask.
      Returns:
      A Java Future containing the result of the GetCampaignAssetActivationTask operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaignAssetExportTask

      default CompletableFuture<GetCampaignAssetExportTaskResponse> getCampaignAssetExportTask(GetCampaignAssetExportTaskRequest getCampaignAssetExportTaskRequest)

      Retrieves a campaign asset export task by its identifier, reporting its status and, when the task is COMPLETED, a freshly minted short-lived presigned URL for downloading the ZIP archive.

      The download URL is minted on each call and is valid for at most 15 minutes; clients should download promptly rather than caching it. When the task has FAILED, FailureReason explains why. Poll this operation (roughly every 2-5 seconds) until the task reaches a terminal state.

      Parameters:
      getCampaignAssetExportTaskRequest - Input for GetCampaignAssetExportTask.

      Takes the catalog, the owning campaign, and the export task identifier. The campaign identifier is required so the operation can be authorized on the task's owning campaign/{CampaignId}: the task is addressable by its id within the caller's partition, but the campaign is not derivable from the task id alone at authorization time.

      Returns:
      A Java Future containing the result of the GetCampaignAssetExportTask operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaignAssetExportTask

      default CompletableFuture<GetCampaignAssetExportTaskResponse> getCampaignAssetExportTask(Consumer<GetCampaignAssetExportTaskRequest.Builder> getCampaignAssetExportTaskRequest)

      Retrieves a campaign asset export task by its identifier, reporting its status and, when the task is COMPLETED, a freshly minted short-lived presigned URL for downloading the ZIP archive.

      The download URL is minted on each call and is valid for at most 15 minutes; clients should download promptly rather than caching it. When the task has FAILED, FailureReason explains why. Poll this operation (roughly every 2-5 seconds) until the task reaches a terminal state.


      This is a convenience which creates an instance of the GetCampaignAssetExportTaskRequest.Builder avoiding the need to create one manually via GetCampaignAssetExportTaskRequest.builder()

      Parameters:
      getCampaignAssetExportTaskRequest - A Consumer that will call methods on GetCampaignAssetExportTaskRequest.Builder to create a request. Input for GetCampaignAssetExportTask.

      Takes the catalog, the owning campaign, and the export task identifier. The campaign identifier is required so the operation can be authorized on the task's owning campaign/{CampaignId}: the task is addressable by its id within the caller's partition, but the campaign is not derivable from the task id alone at authorization time.

      Returns:
      A Java Future containing the result of the GetCampaignAssetExportTask operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaignTemplate

      default CompletableFuture<GetCampaignTemplateResponse> getCampaignTemplate(GetCampaignTemplateRequest getCampaignTemplateRequest)

      Retrieves full detail of one campaign template, including its ordered asset templates with their field schema and layout previews.

      Parameters:
      getCampaignTemplateRequest - Input for GetCampaignTemplate.
      Returns:
      A Java Future containing the result of the GetCampaignTemplate operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • getCampaignTemplate

      default CompletableFuture<GetCampaignTemplateResponse> getCampaignTemplate(Consumer<GetCampaignTemplateRequest.Builder> getCampaignTemplateRequest)

      Retrieves full detail of one campaign template, including its ordered asset templates with their field schema and layout previews.


      This is a convenience which creates an instance of the GetCampaignTemplateRequest.Builder avoiding the need to create one manually via GetCampaignTemplateRequest.builder()

      Parameters:
      getCampaignTemplateRequest - A Consumer that will call methods on GetCampaignTemplateRequest.Builder to create a request. Input for GetCampaignTemplate.
      Returns:
      A Java Future containing the result of the GetCampaignTemplate operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listCampaignAssets

      default CompletableFuture<ListCampaignAssetsResponse> listCampaignAssets(ListCampaignAssetsRequest listCampaignAssetsRequest)

      Lists assets for a campaign with pagination.

      Parameters:
      listCampaignAssetsRequest - Input for ListCampaignAssets operation.
      Returns:
      A Java Future containing the result of the ListCampaignAssets operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listCampaignAssets

      default CompletableFuture<ListCampaignAssetsResponse> listCampaignAssets(Consumer<ListCampaignAssetsRequest.Builder> listCampaignAssetsRequest)

      Lists assets for a campaign with pagination.


      This is a convenience which creates an instance of the ListCampaignAssetsRequest.Builder avoiding the need to create one manually via ListCampaignAssetsRequest.builder()

      Parameters:
      listCampaignAssetsRequest - A Consumer that will call methods on ListCampaignAssetsRequest.Builder to create a request. Input for ListCampaignAssets operation.
      Returns:
      A Java Future containing the result of the ListCampaignAssets operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listCampaignAssetsPaginator

      default ListCampaignAssetsPublisher listCampaignAssetsPaginator(ListCampaignAssetsRequest listCampaignAssetsRequest)

      This is a variant of listCampaignAssets(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignAssetsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListCampaignAssetsPublisher publisher = client.listCampaignAssetsPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListCampaignAssetsPublisher publisher = client.listCampaignAssetsPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignAssetsResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignAssetsResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listCampaignAssets(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignAssetsRequest) operation.

      Parameters:
      listCampaignAssetsRequest - Input for ListCampaignAssets operation.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listCampaignAssetsPaginator

      default ListCampaignAssetsPublisher listCampaignAssetsPaginator(Consumer<ListCampaignAssetsRequest.Builder> listCampaignAssetsRequest)

      This is a variant of listCampaignAssets(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignAssetsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListCampaignAssetsPublisher publisher = client.listCampaignAssetsPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListCampaignAssetsPublisher publisher = client.listCampaignAssetsPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignAssetsResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignAssetsResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listCampaignAssets(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignAssetsRequest) operation.


      This is a convenience which creates an instance of the ListCampaignAssetsRequest.Builder avoiding the need to create one manually via ListCampaignAssetsRequest.builder()

      Parameters:
      listCampaignAssetsRequest - A Consumer that will call methods on ListCampaignAssetsRequest.Builder to create a request. Input for ListCampaignAssets operation.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listCampaigns

      default CompletableFuture<ListCampaignsResponse> listCampaigns(ListCampaignsRequest listCampaignsRequest)

      Lists campaigns with optional filters and pagination.

      Parameters:
      listCampaignsRequest - Input for ListCampaigns operation.

      Filters combine with AND. Results are eventually consistent: a campaign created, renamed or activated a moment ago can take up to a second to appear with its current values. GetCampaign is strongly consistent.

      Returns:
      A Java Future containing the result of the ListCampaigns operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listCampaigns

      default CompletableFuture<ListCampaignsResponse> listCampaigns(Consumer<ListCampaignsRequest.Builder> listCampaignsRequest)

      Lists campaigns with optional filters and pagination.


      This is a convenience which creates an instance of the ListCampaignsRequest.Builder avoiding the need to create one manually via ListCampaignsRequest.builder()

      Parameters:
      listCampaignsRequest - A Consumer that will call methods on ListCampaignsRequest.Builder to create a request. Input for ListCampaigns operation.

      Filters combine with AND. Results are eventually consistent: a campaign created, renamed or activated a moment ago can take up to a second to appear with its current values. GetCampaign is strongly consistent.

      Returns:
      A Java Future containing the result of the ListCampaigns operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listCampaignsPaginator

      default ListCampaignsPublisher listCampaignsPaginator(ListCampaignsRequest listCampaignsRequest)

      This is a variant of listCampaigns(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListCampaignsPublisher publisher = client.listCampaignsPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListCampaignsPublisher publisher = client.listCampaignsPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignsResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignsResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listCampaigns(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignsRequest) operation.

      Parameters:
      listCampaignsRequest - Input for ListCampaigns operation.

      Filters combine with AND. Results are eventually consistent: a campaign created, renamed or activated a moment ago can take up to a second to appear with its current values. GetCampaign is strongly consistent.

      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listCampaignsPaginator

      default ListCampaignsPublisher listCampaignsPaginator(Consumer<ListCampaignsRequest.Builder> listCampaignsRequest)

      This is a variant of listCampaigns(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListCampaignsPublisher publisher = client.listCampaignsPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListCampaignsPublisher publisher = client.listCampaignsPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignsResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignsResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listCampaigns(software.amazon.awssdk.services.partnercentralmarketing.model.ListCampaignsRequest) operation.


      This is a convenience which creates an instance of the ListCampaignsRequest.Builder avoiding the need to create one manually via ListCampaignsRequest.builder()

      Parameters:
      listCampaignsRequest - A Consumer that will call methods on ListCampaignsRequest.Builder to create a request. Input for ListCampaigns operation.

      Filters combine with AND. Results are eventually consistent: a campaign created, renamed or activated a moment ago can take up to a second to appear with its current values. GetCampaign is strongly consistent.

      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listSocialConnections

      default CompletableFuture<ListSocialConnectionsResponse> listSocialConnections(ListSocialConnectionsRequest listSocialConnectionsRequest)

      Lists the partner's social connections, optionally filtered by platform.

      Parameters:
      listSocialConnectionsRequest - Input for ListSocialConnections.
      Returns:
      A Java Future containing the result of the ListSocialConnections operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listSocialConnections

      default CompletableFuture<ListSocialConnectionsResponse> listSocialConnections(Consumer<ListSocialConnectionsRequest.Builder> listSocialConnectionsRequest)

      Lists the partner's social connections, optionally filtered by platform.


      This is a convenience which creates an instance of the ListSocialConnectionsRequest.Builder avoiding the need to create one manually via ListSocialConnectionsRequest.builder()

      Parameters:
      listSocialConnectionsRequest - A Consumer that will call methods on ListSocialConnectionsRequest.Builder to create a request. Input for ListSocialConnections.
      Returns:
      A Java Future containing the result of the ListSocialConnections operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listSocialConnectionsPaginator

      default ListSocialConnectionsPublisher listSocialConnectionsPaginator(ListSocialConnectionsRequest listSocialConnectionsRequest)

      This is a variant of listSocialConnections(software.amazon.awssdk.services.partnercentralmarketing.model.ListSocialConnectionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListSocialConnectionsPublisher publisher = client.listSocialConnectionsPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListSocialConnectionsPublisher publisher = client.listSocialConnectionsPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.partnercentralmarketing.model.ListSocialConnectionsResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.partnercentralmarketing.model.ListSocialConnectionsResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listSocialConnections(software.amazon.awssdk.services.partnercentralmarketing.model.ListSocialConnectionsRequest) operation.

      Parameters:
      listSocialConnectionsRequest - Input for ListSocialConnections.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listSocialConnectionsPaginator

      default ListSocialConnectionsPublisher listSocialConnectionsPaginator(Consumer<ListSocialConnectionsRequest.Builder> listSocialConnectionsRequest)

      This is a variant of listSocialConnections(software.amazon.awssdk.services.partnercentralmarketing.model.ListSocialConnectionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListSocialConnectionsPublisher publisher = client.listSocialConnectionsPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.ListSocialConnectionsPublisher publisher = client.listSocialConnectionsPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.partnercentralmarketing.model.ListSocialConnectionsResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.partnercentralmarketing.model.ListSocialConnectionsResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listSocialConnections(software.amazon.awssdk.services.partnercentralmarketing.model.ListSocialConnectionsRequest) operation.


      This is a convenience which creates an instance of the ListSocialConnectionsRequest.Builder avoiding the need to create one manually via ListSocialConnectionsRequest.builder()

      Parameters:
      listSocialConnectionsRequest - A Consumer that will call methods on ListSocialConnectionsRequest.Builder to create a request. Input for ListSocialConnections.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

      Lists the tags applied to a Partner Central Marketing resource.

      Parameters:
      listTagsForResourceRequest - Input for ListTagsForResource.
      Returns:
      A Java Future containing the result of the ListTagsForResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)

      Lists the tags applied to a Partner Central Marketing resource.


      This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder avoiding the need to create one manually via ListTagsForResourceRequest.builder()

      Parameters:
      listTagsForResourceRequest - A Consumer that will call methods on ListTagsForResourceRequest.Builder to create a request. Input for ListTagsForResource.
      Returns:
      A Java Future containing the result of the ListTagsForResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • searchCampaignTemplates

      default CompletableFuture<SearchCampaignTemplatesResponse> searchCampaignTemplates(SearchCampaignTemplatesRequest searchCampaignTemplatesRequest)

      Searches and browses the AWS-authored campaign template catalog. With no SearchText it returns the whole catalog in the default order, so browse and keyword search share one shape; GetCampaignTemplate reads one template.

      Parameters:
      searchCampaignTemplatesRequest - Input for SearchCampaignTemplates.
      Returns:
      A Java Future containing the result of the SearchCampaignTemplates operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • searchCampaignTemplates

      default CompletableFuture<SearchCampaignTemplatesResponse> searchCampaignTemplates(Consumer<SearchCampaignTemplatesRequest.Builder> searchCampaignTemplatesRequest)

      Searches and browses the AWS-authored campaign template catalog. With no SearchText it returns the whole catalog in the default order, so browse and keyword search share one shape; GetCampaignTemplate reads one template.


      This is a convenience which creates an instance of the SearchCampaignTemplatesRequest.Builder avoiding the need to create one manually via SearchCampaignTemplatesRequest.builder()

      Parameters:
      searchCampaignTemplatesRequest - A Consumer that will call methods on SearchCampaignTemplatesRequest.Builder to create a request. Input for SearchCampaignTemplates.
      Returns:
      A Java Future containing the result of the SearchCampaignTemplates operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • searchCampaignTemplatesPaginator

      default SearchCampaignTemplatesPublisher searchCampaignTemplatesPaginator(SearchCampaignTemplatesRequest searchCampaignTemplatesRequest)

      This is a variant of searchCampaignTemplates(software.amazon.awssdk.services.partnercentralmarketing.model.SearchCampaignTemplatesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.SearchCampaignTemplatesPublisher publisher = client.searchCampaignTemplatesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.SearchCampaignTemplatesPublisher publisher = client.searchCampaignTemplatesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.partnercentralmarketing.model.SearchCampaignTemplatesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.partnercentralmarketing.model.SearchCampaignTemplatesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the searchCampaignTemplates(software.amazon.awssdk.services.partnercentralmarketing.model.SearchCampaignTemplatesRequest) operation.

      Parameters:
      searchCampaignTemplatesRequest - Input for SearchCampaignTemplates.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • searchCampaignTemplatesPaginator

      default SearchCampaignTemplatesPublisher searchCampaignTemplatesPaginator(Consumer<SearchCampaignTemplatesRequest.Builder> searchCampaignTemplatesRequest)

      This is a variant of searchCampaignTemplates(software.amazon.awssdk.services.partnercentralmarketing.model.SearchCampaignTemplatesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.SearchCampaignTemplatesPublisher publisher = client.searchCampaignTemplatesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.partnercentralmarketing.paginators.SearchCampaignTemplatesPublisher publisher = client.searchCampaignTemplatesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.partnercentralmarketing.model.SearchCampaignTemplatesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.partnercentralmarketing.model.SearchCampaignTemplatesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the searchCampaignTemplates(software.amazon.awssdk.services.partnercentralmarketing.model.SearchCampaignTemplatesRequest) operation.


      This is a convenience which creates an instance of the SearchCampaignTemplatesRequest.Builder avoiding the need to create one manually via SearchCampaignTemplatesRequest.builder()

      Parameters:
      searchCampaignTemplatesRequest - A Consumer that will call methods on SearchCampaignTemplatesRequest.Builder to create a request. Input for SearchCampaignTemplates.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • startCampaignAssetActivationTask

      default CompletableFuture<StartCampaignAssetActivationTaskResponse> startCampaignAssetActivationTask(StartCampaignAssetActivationTaskRequest startCampaignAssetActivationTaskRequest)

      Activates 1–25 of a campaign's assets as one ordered unit, and returns a task to poll.

      Takes a list because the service owns the ordering. Assets link to one another by URL — an email's call-to-action carries the landing page's URL, the landing page's download field carries the document's — and a URL does not exist until the asset it points at is activated. Those edges are derived by the service from the campaign's pinned template, so reconstructing and topologically sorting them is work the service has already done, and getting it wrong arms an email with a dead link. Name every asset you want live and the service sequences them; "activate everything" is the list with every id in it, which ListCampaignAssets already gave you.

      Asynchronous, because activating an asset installs or arms behaviour that runs later and an email activation bulk-loads its audience into the delivery platform. Everything decidable without a write to the delivery platform is evaluated before this returns; everything else lands on the task.

      A refusal that applies to one asset does not fail the request: that asset is on the task already FAILED, with its reason, and the rest run. A refusal that applies to the whole request — a malformed list, an unknown campaign, another task already running on this campaign, this service's service-linked role being deleted (ConflictException SERVICE_LINKED_ROLE_DELETION_IN_PROGRESS), a campaign setting an asset in the request needs (ValidationException CAMPAIGN_INCOMPLETE), a campaign sender that no longer passes CreateCampaign's sender rules while the request names an email (ValidationException with no FieldList, whose message ends with one Reason: <code> token per failed rule: PATTERN_MISMATCH, SENDER_DOMAIN_NOT_ALLIANCE_LEAD, or SENDER_DOMAIN_DKIM_MISSING and/or SENDER_DOMAIN_DMARC_MISSING) — is thrown, and nothing starts.

      One task runs on a campaign at a time. A second concurrent call is refused with ConflictException / CAMPAIGN_ACTIVATION_IN_PROGRESS, whose ResourceId names the task already holding the campaign. Two tasks over disjoint asset sets are refused too: the guard is deliberately campaign-wide, because overlapping runs made the per-asset status misleading rather than merely contended.

      Parameters:
      startCampaignAssetActivationTaskRequest - Input for StartCampaignAssetActivationTask.
      Returns:
      A Java Future containing the result of the StartCampaignAssetActivationTask operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • startCampaignAssetActivationTask

      default CompletableFuture<StartCampaignAssetActivationTaskResponse> startCampaignAssetActivationTask(Consumer<StartCampaignAssetActivationTaskRequest.Builder> startCampaignAssetActivationTaskRequest)

      Activates 1–25 of a campaign's assets as one ordered unit, and returns a task to poll.

      Takes a list because the service owns the ordering. Assets link to one another by URL — an email's call-to-action carries the landing page's URL, the landing page's download field carries the document's — and a URL does not exist until the asset it points at is activated. Those edges are derived by the service from the campaign's pinned template, so reconstructing and topologically sorting them is work the service has already done, and getting it wrong arms an email with a dead link. Name every asset you want live and the service sequences them; "activate everything" is the list with every id in it, which ListCampaignAssets already gave you.

      Asynchronous, because activating an asset installs or arms behaviour that runs later and an email activation bulk-loads its audience into the delivery platform. Everything decidable without a write to the delivery platform is evaluated before this returns; everything else lands on the task.

      A refusal that applies to one asset does not fail the request: that asset is on the task already FAILED, with its reason, and the rest run. A refusal that applies to the whole request — a malformed list, an unknown campaign, another task already running on this campaign, this service's service-linked role being deleted (ConflictException SERVICE_LINKED_ROLE_DELETION_IN_PROGRESS), a campaign setting an asset in the request needs (ValidationException CAMPAIGN_INCOMPLETE), a campaign sender that no longer passes CreateCampaign's sender rules while the request names an email (ValidationException with no FieldList, whose message ends with one Reason: <code> token per failed rule: PATTERN_MISMATCH, SENDER_DOMAIN_NOT_ALLIANCE_LEAD, or SENDER_DOMAIN_DKIM_MISSING and/or SENDER_DOMAIN_DMARC_MISSING) — is thrown, and nothing starts.

      One task runs on a campaign at a time. A second concurrent call is refused with ConflictException / CAMPAIGN_ACTIVATION_IN_PROGRESS, whose ResourceId names the task already holding the campaign. Two tasks over disjoint asset sets are refused too: the guard is deliberately campaign-wide, because overlapping runs made the per-asset status misleading rather than merely contended.


      This is a convenience which creates an instance of the StartCampaignAssetActivationTaskRequest.Builder avoiding the need to create one manually via StartCampaignAssetActivationTaskRequest.builder()

      Parameters:
      startCampaignAssetActivationTaskRequest - A Consumer that will call methods on StartCampaignAssetActivationTaskRequest.Builder to create a request. Input for StartCampaignAssetActivationTask.
      Returns:
      A Java Future containing the result of the StartCampaignAssetActivationTask operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • startCampaignAssetExportTask

      default CompletableFuture<StartCampaignAssetExportTaskResponse> startCampaignAssetExportTask(StartCampaignAssetExportTaskRequest startCampaignAssetExportTaskRequest)

      Starts an asynchronous task that packages a campaign's assets into a single downloadable ZIP archive.

      Fire-and-return: the campaign is validated (it must exist and not be cancelled), a task record is persisted, an asynchronous execution is started, and the task id is returned with status IN_PROGRESS. This operation does not inspect assets — all resolution, exclusion, and failure are determined by the execution and surfaced only by GetCampaignAssetExportTask.

      Every campaign is exportable, including one never activated, because renderable assets are composed on demand at export time rather than requiring finished, launched deliverables.

      Parameters:
      startCampaignAssetExportTaskRequest - Input for StartCampaignAssetExportTask.
      Returns:
      A Java Future containing the result of the StartCampaignAssetExportTask operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • startCampaignAssetExportTask

      default CompletableFuture<StartCampaignAssetExportTaskResponse> startCampaignAssetExportTask(Consumer<StartCampaignAssetExportTaskRequest.Builder> startCampaignAssetExportTaskRequest)

      Starts an asynchronous task that packages a campaign's assets into a single downloadable ZIP archive.

      Fire-and-return: the campaign is validated (it must exist and not be cancelled), a task record is persisted, an asynchronous execution is started, and the task id is returned with status IN_PROGRESS. This operation does not inspect assets — all resolution, exclusion, and failure are determined by the execution and surfaced only by GetCampaignAssetExportTask.

      Every campaign is exportable, including one never activated, because renderable assets are composed on demand at export time rather than requiring finished, launched deliverables.


      This is a convenience which creates an instance of the StartCampaignAssetExportTaskRequest.Builder avoiding the need to create one manually via StartCampaignAssetExportTaskRequest.builder()

      Parameters:
      startCampaignAssetExportTaskRequest - A Consumer that will call methods on StartCampaignAssetExportTaskRequest.Builder to create a request. Input for StartCampaignAssetExportTask.
      Returns:
      A Java Future containing the result of the StartCampaignAssetExportTask operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest)

      Adds or replaces tags on a Partner Central Marketing resource.

      Idempotent: applying a tag that is already present with the same value is a no-op, and supplying a key that already exists replaces its value.

      Parameters:
      tagResourceRequest - Input for TagResource.
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ServiceQuotaExceededException The request exceeds a service quota.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)

      Adds or replaces tags on a Partner Central Marketing resource.

      Idempotent: applying a tag that is already present with the same value is a no-op, and supplying a key that already exists replaces its value.


      This is a convenience which creates an instance of the TagResourceRequest.Builder avoiding the need to create one manually via TagResourceRequest.builder()

      Parameters:
      tagResourceRequest - A Consumer that will call methods on TagResourceRequest.Builder to create a request. Input for TagResource.
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ServiceQuotaExceededException The request exceeds a service quota.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest)

      Removes tags from a Partner Central Marketing resource.

      Idempotent: removing a key that is not present succeeds.

      Parameters:
      untagResourceRequest - Input for UntagResource.
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)

      Removes tags from a Partner Central Marketing resource.

      Idempotent: removing a key that is not present succeeds.


      This is a convenience which creates an instance of the UntagResourceRequest.Builder avoiding the need to create one manually via UntagResourceRequest.builder()

      Parameters:
      untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request. Input for UntagResource.
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateCampaign

      default CompletableFuture<UpdateCampaignResponse> updateCampaign(UpdateCampaignRequest updateCampaignRequest)

      Edits a campaign in place.

      Partial update: an omitted field is left unchanged, which is the standard meaning of an Update verb — a full replacement would be a Put. Change-only, with no way to clear a field back to empty, because the campaign's file members cannot round-trip: they are written as an s3:// reference and read back as a URL or as metadata, so a replacement payload could not resend an unchanged recipient list without re-uploading it.

      Refused while an activation task runs (CAMPAIGN_ACTIVATION_IN_PROGRESS) and once the campaign is completed (CAMPAIGN_COMPLETED, the UTC date is after its EndOn).

      Last-writer-wins, with no concurrency token: this is low-contention metadata owned by one partner.

      Parameters:
      updateCampaignRequest - Input for UpdateCampaign operation.
      Returns:
      A Java Future containing the result of the UpdateCampaign operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateCampaign

      default CompletableFuture<UpdateCampaignResponse> updateCampaign(Consumer<UpdateCampaignRequest.Builder> updateCampaignRequest)

      Edits a campaign in place.

      Partial update: an omitted field is left unchanged, which is the standard meaning of an Update verb — a full replacement would be a Put. Change-only, with no way to clear a field back to empty, because the campaign's file members cannot round-trip: they are written as an s3:// reference and read back as a URL or as metadata, so a replacement payload could not resend an unchanged recipient list without re-uploading it.

      Refused while an activation task runs (CAMPAIGN_ACTIVATION_IN_PROGRESS) and once the campaign is completed (CAMPAIGN_COMPLETED, the UTC date is after its EndOn).

      Last-writer-wins, with no concurrency token: this is low-contention metadata owned by one partner.


      This is a convenience which creates an instance of the UpdateCampaignRequest.Builder avoiding the need to create one manually via UpdateCampaignRequest.builder()

      Parameters:
      updateCampaignRequest - A Consumer that will call methods on UpdateCampaignRequest.Builder to create a request. Input for UpdateCampaign operation.
      Returns:
      A Java Future containing the result of the UpdateCampaign operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateCampaignAsset

      default CompletableFuture<UpdateCampaignAssetResponse> updateCampaignAsset(UpdateCampaignAssetRequest updateCampaignAssetRequest)

      Updates an asset's field values, layout or send time. Refused with ConflictException while the campaign's running activation task still owns the asset (ASSET_START_IN_PROGRESS), and for a live email or social post (ASSET_ALREADY_ACTIVE): deactivate it first.

      Parameters:
      updateCampaignAssetRequest - Input for UpdateCampaignAsset operation.
      Returns:
      A Java Future containing the result of the UpdateCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateCampaignAsset

      default CompletableFuture<UpdateCampaignAssetResponse> updateCampaignAsset(Consumer<UpdateCampaignAssetRequest.Builder> updateCampaignAssetRequest)

      Updates an asset's field values, layout or send time. Refused with ConflictException while the campaign's running activation task still owns the asset (ASSET_START_IN_PROGRESS), and for a live email or social post (ASSET_ALREADY_ACTIVE): deactivate it first.


      This is a convenience which creates an instance of the UpdateCampaignAssetRequest.Builder avoiding the need to create one manually via UpdateCampaignAssetRequest.builder()

      Parameters:
      updateCampaignAssetRequest - A Consumer that will call methods on UpdateCampaignAssetRequest.Builder to create a request. Input for UpdateCampaignAsset operation.
      Returns:
      A Java Future containing the result of the UpdateCampaignAsset operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException You do not have sufficient access to perform this action.

        An IAM denial carries no Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence.

      • InternalServerException An unexpected error occurred during the processing of the request.
      • ValidationException The input fails to satisfy the constraints specified by the service.

        A caller branches on Reason, and where the rejection is attributable to particular fields it reads FieldList rather than parsing Message, which is prose and may change.

      • ConflictException The request conflicts with the current state of the resource.
      • ResourceNotFoundException The specified resource does not exist.
      • ThrottlingException The request was denied due to request throttling.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • PartnerCentralMarketingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • serviceClientConfiguration

      default PartnerCentralMarketingServiceClientConfiguration serviceClientConfiguration()
      Description copied from interface: SdkClient
      The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
      Specified by:
      serviceClientConfiguration in interface AwsClient
      Specified by:
      serviceClientConfiguration in interface SdkClient
      Returns:
      SdkServiceClientConfiguration
    • create

      Create a PartnerCentralMarketingAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
    • builder

      Create a builder that can be used to configure and create a PartnerCentralMarketingAsyncClient.