新手求教：Google Cloud Vision API OCR的C#认证与调用步骤

作为新手，我完全理解你摸不着头绪的感觉，别担心，我一步步带你搞定从获取密钥到调用API的全流程。

一、获取Google Cloud服务账号密钥（替代传统订阅密钥） #

Google Cloud API采用服务账号密钥完成认证，咱们按以下步骤操作：

• 登录Google Cloud控制台，先创建一个新项目（如果还没有的话）：点击左上角项目下拉框，选择"新建项目"，输入名称后完成创建。
• 启用Cloud Vision API：在控制台顶部搜索框输入"Cloud Vision API"，找到对应服务后点击"启用"，等待几秒完成启用。
• 创建服务账号：进入"IAM与Admin" -> "服务账号"页面，点击"创建服务账号"，输入账号名称和ID，点击"创建并继续"。
• 分配权限：在"授予此服务账号访问权限"步骤，搜索并选择"Cloud Vision API Editor"（或者更严格的"Cloud Vision API Viewer"，按需选择），点击"继续"后完成创建。
• 下载密钥文件：回到服务账号列表，点击刚创建的账号进入详情页，切换到"密钥"标签，点击"添加密钥" -> "创建新密钥"，选择"JSON"格式，点击"创建"，浏览器会自动下载一个JSON文件，务必保存好这个文件的路径，后面要用。

二、C#项目配置与认证准备 #

接下来搭建C#项目的基础环境：

• 打开Visual Studio，创建一个新的控制台应用（用控制台举例最直观，其他项目类型操作类似）。
• 安装NuGet包：右键项目 -> "管理NuGet程序包"，搜索Google.Cloud.Vision.V1并安装；或者在Package Manager Console里执行命令：

  Install-Package Google.Cloud.Vision.V1
  

• 配置认证：有两种方式，测试阶段推荐第二种，正式环境优先第一种：
  1. 环境变量方式：把刚才下载的JSON文件路径设置到系统环境变量GOOGLE_APPLICATION_CREDENTIALS里。Windows可在系统属性->高级->环境变量中添加，Mac/Linux可在终端执行export GOOGLE_APPLICATION_CREDENTIALS="/你的密钥文件路径/xxx.json"。
  2. 代码指定路径：直接在代码里加载密钥文件，适合快速测试。

三、编写C#代码调用OCR功能 #

现在来写核心代码，实现图片文本检测：

using Google.Cloud.Vision.V1;
using System;

namespace VisionOcrDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 方式1：已设置环境变量时，直接初始化客户端
            // var client = ImageAnnotatorClient.Create();

            // 方式2：代码指定密钥文件路径（测试用）
            var client = ImageAnnotatorClient.FromCredentialFile("你的密钥文件完整路径/xxx.json");

            // 加载要检测的图片，支持本地路径或网络图片
            var image = Image.FromFile("本地图片路径/xxx.jpg"); // 也可以用Image.FromUri("https://example.com/xxx.jpg")

            try
            {
                // 调用文本检测API
                var response = client.DetectText(image);

                // 处理并输出检测结果
                foreach (var annotation in response)
                {
                    if (!string.IsNullOrEmpty(annotation.Description))
                    {
                        Console.WriteLine("检测到的文本内容：");
                        Console.WriteLine(annotation.Description);
                        Console.WriteLine("------------------------");
                    }
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"调用API出错：{ex.Message}");
            }
        }
    }
}

一些实用注意事项 #

• 计费提醒：Google Cloud Vision API有每月1000次请求的免费额度，超过后会产生费用，记得在控制台查看计费状态，避免意外扣费。
• 图片要求：支持JPEG、PNG、GIF、BMP等格式，图片大小不能超过20MB，常规尺寸的图片都能正常检测。
• 权限检查：如果调用时报认证错误，先检查服务账号的权限是否正确分配，密钥文件路径是否无误。

内容的提问来源于stack exchange，提问作者Manisha P