Class: Basecamp::Services::DocumentsService

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

Overview

Service for Documents operations

Instance Method Summary collapse

Constructor Details

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

Instance Method Details

#create(vault_id:, title:, content: nil, status: nil, subscriptions: nil, visible_to_clients: nil) ⇒ Hash

Create a new document in a vault

Parameters:

  • vault_id (Integer) —

    vault id ID

  • title (String) —

    title

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

    content

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

    active|drafted

  • subscriptions (Array, nil) (defaults to: nil) —

    subscriptions

  • visible_to_clients (Boolean, nil) (defaults to: nil) —

    visible to clients

Returns:

  • (Hash) —

    response data



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

def create(vault_id:, title:, content: nil, status: nil, subscriptions: nil, visible_to_clients: nil)
  with_operation(service: "documents", operation: "create", is_mutation: true, resource_id: vault_id) do
    http_post("/vaults/#{vault_id}/documents.json", body: compact_params(title: title, content: content, status: status, subscriptions: subscriptions, visible_to_clients: visible_to_clients)).json
  end
end

#get(document_id:) ⇒ Hash

Get a single document by id

Parameters:

  • document_id (Integer) —

    document id ID

Returns:

  • (Hash) —

    response data



13
14
15
16
17
 
# File 'lib/basecamp/generated/services/documents_service.rb', line 13

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

#list(vault_id:) ⇒ Enumerator<Hash>

List documents in a vault

Parameters:

  • vault_id (Integer) —

    vault id ID

Returns:

  • (Enumerator<Hash>) —

    paginated results



33
34
35
36
37
 
# File 'lib/basecamp/generated/services/documents_service.rb', line 33

def list(vault_id:)
  wrap_paginated(service: "documents", operation: "list", is_mutation: false, resource_id: vault_id) do
    paginate("/vaults/#{vault_id}/documents.json")
  end
end

#update(document_id:, title: nil, content: nil) ⇒ Hash

Update an existing document

Parameters:

  • document_id (Integer) —

    document id ID

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

    title

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

    content

Returns:

  • (Hash) —

    response data



24
25
26
27
28
 
# File 'lib/basecamp/generated/services/documents_service.rb', line 24

def update(document_id:, title: nil, content: nil)
  with_operation(service: "documents", operation: "update", is_mutation: true, resource_id: document_id) do
    http_put("/documents/#{document_id}", body: compact_params(title: title, content: content)).json
  end
end