googlebooks-rs 0.2.2

A Rust client library for the Google Books API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use serde::Deserialize;

/// Main response from Google Books API
#[derive(Deserialize, Debug)]
pub struct VolumeResponse {
    pub kind: String,
    #[serde(rename(deserialize = "totalItems"))]
    pub total_items: i32,
    pub items: Option<Vec<Book>>,
}

/// Represents a book with its basic metadata
#[derive(Deserialize, Debug)]
pub struct Book {
    pub id: String,
    pub etag: String,
    pub kind: Option<String>,
    #[serde(rename(deserialize = "selfLink"))]
    pub self_link: Option<String>,
    #[serde(rename(deserialize = "volumeInfo"))]
    pub volume_info: VolumeInfo,
}

/// Detailed information about a book
#[derive(Deserialize, Debug)]
pub struct VolumeInfo {
    pub title: String,
    pub subtitle: Option<String>,
    pub authors: Option<Vec<String>>,
    pub publisher: Option<String>,
    #[serde(rename(deserialize = "publishedDate"))]
    pub published_date: Option<String>,
    pub description: Option<String>,
    #[serde(rename(deserialize = "industryIdentifiers"))]
    pub industry_identifiers: Option<Vec<IndustryIdentifiers>>,
    #[serde(rename(deserialize = "pageCount"))]
    pub page_count: Option<u16>,
    #[serde(
        rename(deserialize = "printType"),
        default = "VolumeInfo::default_print_type"
    )]
    pub print_type: String,
    pub categories: Option<Vec<String>>,
    #[serde(rename(deserialize = "imageLinks"))]
    pub image_links: Option<ImageLink>,
}

impl VolumeInfo {
    pub fn default_print_type() -> String {
        "".to_string()
    }
}

/// Links to cover images
#[derive(Deserialize, Debug)]
pub struct ImageLink {
    #[serde(rename(deserialize = "smallThumbnail"))]
    pub small_thumbnail: Option<String>,
    pub thumbnail: Option<String>,
}

/// Book standard identifiers (ISBN-10, ISBN-13, etc.)
#[derive(Deserialize, Debug)]
pub struct IndustryIdentifiers {
    pub identifier: String,
    #[serde(rename(deserialize = "type"))]
    pub identifier_type: String,
}

/// Error of Google Book API
#[derive(Debug, Deserialize)]
pub struct GoogleApiError {
    pub error: GoogleApiErrorDetail,
}

/// Detail of error
#[derive(Debug, Deserialize)]
pub struct GoogleApiErrorDetail {
    /// CODE error
    pub code: u16,
    /// Error description
    pub message: String,
    pub status: Option<String>,
    pub errors: Option<Vec<GoogleApiErrorItem>>,
}

#[derive(Debug, Deserialize)]
pub struct GoogleApiErrorItem {
    pub message: String,
    pub domain: String,
    pub reason: String,
}