Class: Basecamp::Services::RecordingsService

Inherits:
BaseService
  • Object
show all
Defined in:
lib/basecamp/generated/services/recordings_service.rb

Overview

Service for Recordings operations

Instance Method Summary collapse

Constructor Details

This class inherits a constructor from Basecamp::Services::BaseService

Instance Method Details

#archive(recording_id:) ⇒ void

This method returns an undefined value.

Archive a recording

Parameters:

  • recording_id (Integer) —

    recording id ID



46
47
48
49
50
51
 
# File 'lib/basecamp/generated/services/recordings_service.rb', line 46

def archive(recording_id:)
  with_operation(service: "recordings", operation: "archive", is_mutation: true, resource_id: recording_id) do
    http_put("/recordings/#{recording_id}/status/archived.json")
    nil
  end
end

#get(recording_id:) ⇒ Hash

Get a single recording by id

Parameters:

  • recording_id (Integer) —

    recording id ID

Returns:

  • (Hash) —

    response data



27
28
29
30
31
 
# File 'lib/basecamp/generated/services/recordings_service.rb', line 27

def get(recording_id:)
  with_operation(service: "recordings", operation: "get", is_mutation: false, resource_id: recording_id) do
    http_get("/recordings/#{recording_id}").json
  end
end

#list(type:, bucket: nil, status: nil, sort: nil, direction: nil) ⇒ Enumerator<Hash>

List recordings of a given type across projects

Parameters:

  • type (String) —

    Comment|Document|Kanban::Card|Kanban::Step|Message|Question::Answer|Schedule::Entry|Todo|Todolist|Upload|Vault

  • bucket (String, nil) (defaults to: nil) —

    bucket

  • status (String, nil) (defaults to: nil) —

    active|archived|trashed

  • sort (String, nil) (defaults to: nil) —

    created_at|updated_at

  • direction (String, nil) (defaults to: nil) —

    asc|desc

Returns:

  • (Enumerator<Hash>) —

    paginated results



17
18
19
20
21
22
 
# File 'lib/basecamp/generated/services/recordings_service.rb', line 17

def list(type:, bucket: nil, status: nil, sort: nil, direction: nil)
  wrap_paginated(service: "recordings", operation: "list", is_mutation: false) do
    params = compact_query_params(type: type, bucket: bucket, status: status, sort: sort, direction: direction)
    paginate("/projects/recordings.json", params: params)
  end
end

#trash(recording_id:) ⇒ void

This method returns an undefined value.

Trash a recording

Parameters:

  • recording_id (Integer) —

    recording id ID



56
57
58
59
60
61
 
# File 'lib/basecamp/generated/services/recordings_service.rb', line 56

def trash(recording_id:)
  with_operation(service: "recordings", operation: "trash", is_mutation: true, resource_id: recording_id) do
    http_put("/recordings/#{recording_id}/status/trashed.json")
    nil
  end
end

#unarchive(recording_id:) ⇒ void

This method returns an undefined value.

Unarchive a recording (restore to active status)

Parameters:

  • recording_id (Integer) —

    recording id ID



36
37
38
39
40
41
 
# File 'lib/basecamp/generated/services/recordings_service.rb', line 36

def unarchive(recording_id:)
  with_operation(service: "recordings", operation: "unarchive", is_mutation: true, resource_id: recording_id) do
    http_put("/recordings/#{recording_id}/status/active.json")
    nil
  end
end