Struct TranslateService 

pub struct TranslateService { /* private fields */ }

Implementations

impl TranslateService

pub async fn translate( &mut self, text: Vec<&str>, target: &str, params: Option<HashMap<String, Value>>, ) -> Result<TranslateTextResponse>

Translates text into the target language.
See https://g.co/cloud/translate/v2/translate-reference#supported_languages https://cloud.google.com/translate/docs/reference/rest/v2/translate https://cloud.google.com/translate/docs/basic/translating-text#translate_translate_text-drest

• text - an array of strings to be translated.
• target - The language to use for translation of the input text.
• params - Optional Additional Parameter. Keys accepted are the following.
  • format - The format of the source text, in either HTML (default) or plain-text. A value of html indicates HTML and a value of text indicates plain-text.
  • source - The language of the source text.
  • model - The translation model. Cloud Translation - Basic offers only the nmt Neural Machine Translation (NMT) model. If the model is base, the request is translated by using the NMT model.

Examples found in repository

examples/translate_service.rs (line 30)

async fn translate() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut translation_service = TranslateService::new_with_api_key(api_key);
    let response = translation_service.translate(vec!["test"], "ja", None).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut translation_service = TranslateService::new_with_credentials(credentials);
    let response = translation_service.translate(vec!["test"], "ja", None).await?;
    println!("response: {}", serde_json::to_string(&response)?);
    let mut params: HashMap<String, Value> = HashMap::new();
    params.insert("format".to_string(), "text".into());
    params.insert("source".to_string(), "en".into());
    params.insert(" model".to_string(), "base".into());
    let response_with_params = translation_service.translate(vec!["test2"], "ja", Some(params)).await?;
    println!("response_with_params: {}", serde_json::to_string(&response_with_params)?);

    Ok(())
}

impl TranslateService

pub async fn list_languages( &mut self, target: Option<&str>, model: Option<&str>, ) -> Result<ListLanguageResponse>

List supported languages.
See https://cloud.google.com/translate/docs/basic/discovering-supported-languages

• target - The target language code for the results. If specified, then the language names are returned in the name field of the response, localized in the target language. If you do not supply a target language, then the name field is omitted from the response and only the language codes are returned.
• model - The supported languages for a particular translation model. For Cloud Translation - Basic, the value can be nmt to return languages supported by the Neural Machine Translation (NMT) model.

Examples found in repository

examples/translate_service.rs (line 56)

async fn list_languages() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut translation_service = TranslateService::new_with_api_key(api_key);
    let response = translation_service.list_languages(Some("ja"), None).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut translation_service = TranslateService::new_with_credentials(credentials);
    let response = translation_service.list_languages(Some("ja"), None).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    Ok(())
}

impl TranslateService

pub async fn detect_language( &mut self, text: Vec<&str>, ) -> Result<DetectLanguageResponse>

Detects the language of texts.
See https://cloud.google.com/translate/docs/basic/detecting-language

• text - an array of strings to upon which to perform language detection.

Examples found in repository

examples/translate_service.rs (line 76)

async fn detect_language() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut translation_service = TranslateService::new_with_api_key(api_key);
    let response = translation_service.detect_language(vec!["test", "テスト"]).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut translation_service = TranslateService::new_with_credentials(credentials);
    let response = translation_service.detect_language(vec!["test", "テスト"]).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    Ok(())
}

impl TranslateService

pub fn new_with_api_key(api_key: String) -> Self

Create TranslateService Authenticate by using API keys.

• api_key - API key to use to authenticate to Google Cloud APIs and services that support API keys.

Examples found in repository

examples/translate_service.rs (line 29)

async fn translate() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut translation_service = TranslateService::new_with_api_key(api_key);
    let response = translation_service.translate(vec!["test"], "ja", None).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut translation_service = TranslateService::new_with_credentials(credentials);
    let response = translation_service.translate(vec!["test"], "ja", None).await?;
    println!("response: {}", serde_json::to_string(&response)?);
    let mut params: HashMap<String, Value> = HashMap::new();
    params.insert("format".to_string(), "text".into());
    params.insert("source".to_string(), "en".into());
    params.insert(" model".to_string(), "base".into());
    let response_with_params = translation_service.translate(vec!["test2"], "ja", Some(params)).await?;
    println!("response_with_params: {}", serde_json::to_string(&response_with_params)?);

    Ok(())
}


async fn list_languages() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut translation_service = TranslateService::new_with_api_key(api_key);
    let response = translation_service.list_languages(Some("ja"), None).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut translation_service = TranslateService::new_with_credentials(credentials);
    let response = translation_service.list_languages(Some("ja"), None).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    Ok(())
}


async fn detect_language() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut translation_service = TranslateService::new_with_api_key(api_key);
    let response = translation_service.detect_language(vec!["test", "テスト"]).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut translation_service = TranslateService::new_with_credentials(credentials);
    let response = translation_service.detect_language(vec!["test", "テスト"]).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    Ok(())
}

pub fn new_with_credentials( service_account_credentials: ServiceAccountCredentials, ) -> Self

Create TranslateService Authenticate by using API keys.

• service_account_credentials - ServiceAccountCredentials to use to authenticate to Google Cloud APIs.

Examples found in repository

examples/translate_service.rs (line 36)

async fn translate() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut translation_service = TranslateService::new_with_api_key(api_key);
    let response = translation_service.translate(vec!["test"], "ja", None).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut translation_service = TranslateService::new_with_credentials(credentials);
    let response = translation_service.translate(vec!["test"], "ja", None).await?;
    println!("response: {}", serde_json::to_string(&response)?);
    let mut params: HashMap<String, Value> = HashMap::new();
    params.insert("format".to_string(), "text".into());
    params.insert("source".to_string(), "en".into());
    params.insert(" model".to_string(), "base".into());
    let response_with_params = translation_service.translate(vec!["test2"], "ja", Some(params)).await?;
    println!("response_with_params: {}", serde_json::to_string(&response_with_params)?);

    Ok(())
}


async fn list_languages() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut translation_service = TranslateService::new_with_api_key(api_key);
    let response = translation_service.list_languages(Some("ja"), None).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut translation_service = TranslateService::new_with_credentials(credentials);
    let response = translation_service.list_languages(Some("ja"), None).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    Ok(())
}


async fn detect_language() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut translation_service = TranslateService::new_with_api_key(api_key);
    let response = translation_service.detect_language(vec!["test", "テスト"]).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut translation_service = TranslateService::new_with_credentials(credentials);
    let response = translation_service.detect_language(vec!["test", "テスト"]).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    Ok(())
}

Trait Implementations

impl Clone for TranslateService

fn clone(&self) -> TranslateService

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TranslateService

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.