Google App脚本中的Nexmo API调用

Google Apps Script 中调用 Nexmo API 的完整指南

基础概念

Nexmo API（现为Vonage API的一部分）是一组通信API，允许开发者通过短信、语音、验证等功能集成通信能力到应用中。Google Apps Script (GAS)是Google提供的基于JavaScript的云脚本语言，用于扩展Google Workspace应用功能。

调用Nexmo API的类型

短信API
语音API
验证API
号码洞察API

应用场景

通过Google表单提交自动发送短信确认
从Google Sheets批量发送短信通知
基于Google日历事件触发语音提醒
两步验证集成到Google Workspace应用

实现代码示例

1. 发送短信示例

function sendSMS() {
  var apiKey = 'YOUR_NEXMO_API_KEY';
  var apiSecret = 'YOUR_NEXMO_API_SECRET';
  var fromNumber = 'NEXMO_VIRTUAL_NUMBER';
  var toNumber = 'RECIPIENT_NUMBER';
  var messageText = 'Hello from Google Apps Script!';
  
  var url = 'https://rest.nexmo.com/sms/json?' +
    'api_key=' + encodeURIComponent(apiKey) +
    '&api_secret=' + encodeURIComponent(apiSecret) +
    '&from=' + encodeURIComponent(fromNumber) +
    '&to=' + encodeURIComponent(toNumber) +
    '&text=' + encodeURIComponent(messageText);
  
  var response = UrlFetchApp.fetch(url, {
    method: 'GET',
    muteHttpExceptions: true
  });
  
  var result = JSON.parse(response.getContentText());
  Logger.log(result);
  
  if (result.messages[0].status === '0') {
    Logger.log('Message sent successfully');
  } else {
    Logger.log('Message failed with error: ' + result.messages[0]['error-text']);
  }
}

2. 验证API示例

function startVerification() {
  var apiKey = 'YOUR_NEXMO_API_KEY';
  var apiSecret = 'YOUR_NEXMO_API_SECRET';
  var phoneNumber = 'USER_PHONE_NUMBER';
  var brandName = 'YOUR_APP_NAME';
  
  var url = 'https://api.nexmo.com/verify/json?' +
    'api_key=' + encodeURIComponent(apiKey) +
    '&api_secret=' + encodeURIComponent(apiSecret) +
    '&number=' + encodeURIComponent(phoneNumber) +
    '&brand=' + encodeURIComponent(brandName);
  
  var response = UrlFetchApp.fetch(url, {
    method: 'GET',
    muteHttpExceptions: true
  });
  
  var result = JSON.parse(response.getContentText());
  
  if (result.status === '0') {
    Logger.log('Verification request sent, request_id: ' + result.request_id);
    return result.request_id;
  } else {
    Logger.log('Error: ' + result.error_text);
    return null;
  }
}

function checkVerification(requestId, code) {
  var apiKey = 'YOUR_NEXMO_API_KEY';
  var apiSecret = 'YOUR_NEXMO_API_SECRET';
  
  var url = 'https://api.nexmo.com/verify/check/json?' +
    'api_key=' + encodeURIComponent(apiKey) +
    '&api_secret=' + encodeURIComponent(apiSecret) +
    '&request_id=' + encodeURIComponent(requestId) +
    '&code=' + encodeURIComponent(code);
  
  var response = UrlFetchApp.fetch(url, {
    method: 'GET',
    muteHttpExceptions: true
  });
  
  var result = JSON.parse(response.getContentText());
  
  if (result.status === '0') {
    Logger.log('Verification successful');
    return true;
  } else {
    Logger.log('Verification failed: ' + result.error_text);
    return false;
  }
}

常见问题及解决方案

1. 请求失败

原因：

API密钥或密钥不正确
配额用尽
电话号码格式错误

解决：

检查API凭证
验证电话号码格式（包括国家代码）
检查Nexmo账户余额或配额

2. 响应解析错误

原因：

API返回非JSON格式
网络问题导致响应不完整

解决：

添加错误处理
检查muteHttpExceptions设置
实现重试机制

try {
  var response = UrlFetchApp.fetch(url, {
    method: 'GET',
    muteHttpExceptions: true
  });
  var result = JSON.parse(response.getContentText());
} catch (e) {
  Logger.log('Error parsing response: ' + e);
}