Class: HubSpotSDK::Resources::CommunicationPreferences::Statuses::Batch

Inherits:
Object
  • Object
show all
Defined in:
lib/hubspot_sdk/resources/communication_preferences/statuses/batch.rb

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ Batch

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Batch.

Parameters:



129
130
131
 
# File 'lib/hubspot_sdk/resources/communication_preferences/statuses/batch.rb', line 129

def initialize(client:)
  @client = client
end

Instance Method Details

#get_unsubscribe_all_statuses(channel:, inputs:, business_unit_id: nil, request_options: {}) ⇒ HubSpotSDK::Models::CommunicationPreferences::BatchResponsePublicWideStatusBulkResponse

Checks whether a set of contacts have opted out of all communications.

Parameters:

  • channel (Symbol, HubSpotSDK::Models::BatchInputString::Channel) —

    Query param

  • inputs (Array<String>) —

    Body param: Strings to input.

  • business_unit_id (Integer) —

    Query param

  • request_options (HubSpotSDK::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



23
24
25
26
27
28
29
30
31
32
33
34
35
36
 
# File 'lib/hubspot_sdk/resources/communication_preferences/statuses/batch.rb', line 23

def get_unsubscribe_all_statuses(params)
  query_params = [:channel, :business_unit_id]
  parsed, options =
    HubSpotSDK::CommunicationPreferences::Statuses::BatchGetUnsubscribeAllStatusesParams.dump_request(params)
  query = HubSpotSDK::Internal::Util.encode_query_params(parsed.slice(*query_params))
  @client.request(
    method: :post,
    path: "communication-preferences/2026-03/statuses/batch/unsubscribe-all/read",
    query: query.transform_keys(business_unit_id: "businessUnitId"),
    body: parsed.except(*query_params),
    model: HubSpotSDK::CommunicationPreferences::BatchResponsePublicWideStatusBulkResponse,
    options: options
  )
end

#read(channel:, inputs:, business_unit_id: nil, request_options: {}) ⇒ HubSpotSDK::Models::CommunicationPreferences::BatchResponsePublicStatusBulkResponse

Batch retrieve subscription statuses for a set of contacts.

Parameters:

  • channel (Symbol, HubSpotSDK::Models::BatchInputString::Channel) —

    Query param

  • inputs (Array<String>) —

    Body param: Strings to input.

  • business_unit_id (Integer) —

    Query param

  • request_options (HubSpotSDK::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



53
54
55
56
57
58
59
60
61
62
63
64
65
 
# File 'lib/hubspot_sdk/resources/communication_preferences/statuses/batch.rb', line 53

def read(params)
  query_params = [:channel, :business_unit_id]
  parsed, options = HubSpotSDK::CommunicationPreferences::Statuses::BatchReadParams.dump_request(params)
  query = HubSpotSDK::Internal::Util.encode_query_params(parsed.slice(*query_params))
  @client.request(
    method: :post,
    path: "communication-preferences/2026-03/statuses/batch/read",
    query: query.transform_keys(business_unit_id: "businessUnitId"),
    body: parsed.except(*query_params),
    model: HubSpotSDK::CommunicationPreferences::BatchResponsePublicStatusBulkResponse,
    options: options
  )
end

#unsubscribe_all(channel:, inputs:, business_unit_id: nil, verbose: nil, request_options: {}) ⇒ HubSpotSDK::Models::CommunicationPreferences::BatchResponsePublicBulkOptOutFromAllResponse

Unsubscribe a set of contacts from all email subscriptions.

Parameters:

  • channel (Symbol, HubSpotSDK::Models::BatchInputString::Channel) —

    Query param

  • inputs (Array<String>) —

    Body param: Strings to input.

  • business_unit_id (Integer) —

    Query param

  • verbose (Boolean) —

    Query param

  • request_options (HubSpotSDK::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



84
85
86
87
88
89
90
91
92
93
94
95
96
97
 
# File 'lib/hubspot_sdk/resources/communication_preferences/statuses/batch.rb', line 84

def unsubscribe_all(params)
  query_params = [:channel, :business_unit_id, :verbose]
  parsed, options =
    HubSpotSDK::CommunicationPreferences::Statuses::BatchUnsubscribeAllParams.dump_request(params)
  query = HubSpotSDK::Internal::Util.encode_query_params(parsed.slice(*query_params))
  @client.request(
    method: :post,
    path: "communication-preferences/2026-03/statuses/batch/unsubscribe-all",
    query: query.transform_keys(business_unit_id: "businessUnitId"),
    body: parsed.except(*query_params),
    model: HubSpotSDK::CommunicationPreferences::BatchResponsePublicBulkOptOutFromAllResponse,
    options: options
  )
end

#update_statuses(inputs:, request_options: {}) ⇒ HubSpotSDK::Models::CommunicationPreferences::BatchResponsePublicStatus

Some parameter documentations has been truncated, see Models::CommunicationPreferences::Statuses::BatchUpdateStatusesParams for more details.

Update the subscription status for a set of contacts.

Parameters:

Returns:

See Also:



114
115
116
117
118
119
120
121
122
123
124
 
# File 'lib/hubspot_sdk/resources/communication_preferences/statuses/batch.rb', line 114

def update_statuses(params)
  parsed, options =
    HubSpotSDK::CommunicationPreferences::Statuses::BatchUpdateStatusesParams.dump_request(params)
  @client.request(
    method: :post,
    path: "communication-preferences/2026-03/statuses/batch/write",
    body: parsed,
    model: HubSpotSDK::CommunicationPreferences::BatchResponsePublicStatus,
    options: options
  )
end