百度PCS 入门使用示例

PCS API目前主要分为文件API和结构化数据API。
 

下面将会提供几个示例帮助您理解如何使用REST API和SDK。

获取Access Token示例

在您进行PCS API调用之前，首先按照Implicit Grant方法获取Access Token。

1. 请您将以下HTTP请求直接粘贴到浏览器地址栏内，并按下回车键。

https://openapi.baidu.com/oauth/2.0/authorize?response_type=token&client_id=L6g70tBRRIXLsY0Z3HwKqlRE&redirect_uri=oob&scope=netdisk
说明:

“client_id=L6g70tBRRIXLsY0Z3HwKqlRE”为百度为开发者提供的PCS Demo API key，供您快速学习时使用。实际开发中，应该使用您创建的应用所对应的API Key，并保证已经通过了PCS API使用授权。


2. 执行后，弹出百度登录页面，登录后弹出以下授权页面：

pcs_104.jpg


3. 请选择"百度网盘访问权限"，并单击授权，否则无法获取Access Token。

4. 授权后，将跳转到以下百度OAuth2.0页面：

5. 请将此页面地址栏的内容拷贝出来，您将看到：

http://openapi.baidu.com/oauth/2.0/login_success#expires_in=2592000&access_token=3.811a254908d094012df764a38882a179.2592000.1348661720.2233553628-238347&session_secret=9deaa587f9cd177f02079506dc4391ab&session_key=94rrnl7qf2cYVnSZ0KfARwLS%2BIMuQn%2FbZKgbYBEnwDZv1O%2Bzp7fJxo8cN%2BrrhLAQsJy8FeBD2SP6Ioux%2B2TW6IgR8JFIGsU%3D&scope=basic+netdisk
说明:

“access_token=3.811a254908d094012df764a38882a179.2592000.1348661720.2233553628-238347”就是您本次获取到的Access Token值。在具体操作过程中，您将获得一个与示例中完全不同的，与您的账号绑定的Access Token值，请您保存下来，做为后续操作的输入。

使用REST API

以获取空间信息接口（quota）为例说明如何使用PCS REST API：

1. 请您将以下HTTP请求直接粘贴到浏览器地址栏内，并按下回车键。

https://pcs.baidu.com/rest/2.0/pcs/quota?method=info&access_token=YOUR_ACCESS_TOKEN

其中，access_token=YOUR_ACCESS_TOKEN就是您刚刚在上一步骤中获取到的Access Token值。

2. 当您看到页面中出现以下格式的内容时，意味着您已经成功地使用了一次PCS REST API。

pcs_19.jpg

注意:

quota、used、request_id会根据具体的执行环境有所变化。

使用PHP SDK

以获得空间信息接口（quota）为例来介绍如何使用PHP SDK。

1. 尝试以下示例之前，您首先需要下载PCS PHP Demo。

2. 请将YOUR_ACCESS_TOKEN换成您刚刚在上述步骤中获取到的Access Token值。

<?php
    require_once('pcs.class.php'); //引入pcs.class.php源文件

    //设置access token
    $auth = array('access_token' => 'YOUR_ACCESS_TOKEN');
    $pcs = new BaiduPCS($auth); //初始化BaiduPCS类
    $pcs->set_ssl(true); //设置HTTPS访问方式
    echo "n";

    //调用quota接口获取用户空间信息
    if (!($data = $pcs->info_quota())) {
        //错误情况
        var_dump($pcs->get_error_message());
        return;
    } else {
        //打印获取的quota信息
        echo json_encode($data);
    }

    echo "n";
 ?>


3. 运行结果：

pcs_17.jpg

使用Android SDK

以获得空间信息接口（quota）为例来介绍如何使用Android SDK。

1. 配置好Android开发环境并下载Android SDK。
了解配置Android开发环境的详细信息，请参考http://developer.android.com/index.html。
请您下载Android SDK：Baidu-PCS-SDK-Android-L2-2.1.0.zip。

2. 从下载包中的Baidu-PCS-SDK-Android-L2-2.1.0.ziplib目录中得到所有的Jar包：

Baidu-OAuth-SDK-Android-G-2.0.0.jar
Baidu-PCS-SDK-Android-L2-2.1.0.jar
httpmime-4.2.jar


3. 在Eclipse创建一个Android应用程序。

4. 修改AndroidManifest.xml，增加以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />


5. 修改layout/main.xml，向其中添加button widget：

<<Button
android:id="@+id/login"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentTop="true"
android:layout_centerHorizontal="true"
android:layout_marginTop="62dp"
android:text="Login" />

<Button
android:id="@+id/getquota"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_above="@+id/tokenView"
android:layout_centerHorizontal="true"
android:layout_marginBottom="34dp"
android:text="Get Quota" />

6. 进入项目libs目录，将下载的包中的Demo/libs中的所有jar包拷贝到此libs目录，然后并将他们加入Android程序的Build Path中。
 

pcs_105.jpg


7. 修改工程中默认的MainActivity.java。
1) Import 库

importcom.baidu.oauth.BaiduOAuth;
importcom.baidu.oauth.BaiduOAuth.BaiduOAuthResponse;
importcom.baidu.oauth.BaiduOAuth.OAuthListener;
importcom.baidu.pcs.BaiduPCSActionInfo;
importcom.baidu.pcs.BaiduPCSClient;
importandroid.widget.Button;
importandroid.widget.Toast;

2) 设定用户API Key。

private final String mbApiKey = "L6g70tBRRIXLsY0Z3HwKqlRE";//请替换申请客户端应用时获取的Api Key串
private final String mbRootPath =  "/apps/pcstest_oauth"; //用户测试的根目录

3) 添加按钮响应事件。

private Button login;
private Button getQuota;
private String mbOauth = null;
private Handler mbUiThreadHandler = null;
	
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
	
mbUiThreadHandler = new Handler();
login = (Button) this.findViewById(R.id.login);

getQuota = (Button) this.findViewById(R.id.getquota);
	
login.setOnClickListener(new OnClickListener() {
        @Override
public void onClick(View v) {
BaiduOAuthoauthClient = new BaiduOAuth();
oauthClient.startOAuth(MainActivity.this, mbApiKey, new String[]{"basic", "netdisk"}, new BaiduOAuth.OAuthListener() {
                @Override
public void onException(String msg) {
Toast.makeText(getApplicationContext(), "Login failed " + msg, Toast.LENGTH_SHORT).show();
                }
                @Override
public void onComplete(BaiduOAuthResponse response) {
if(null != response){
mbOauth = response.getAccessToken();
Toast.makeText(getApplicationContext(), "Token: " + mbOauth + "    User name:" + response.getUserName(), Toast.LENGTH_SHORT).show();
                    }
                }
                @Override
public void onCancel() {
Toast.makeText(getApplicationContext(), "Login cancelled", Toast.LENGTH_SHORT).show();
                }
            });
        }
    });

getQuota.setOnClickListener(new Button.OnClickListener(){
public void onClick(View v) {
test_getQuota();
            } 
    });
}

private void test_getQuota(){

if(null != mbOauth){
	    Thread workThread = new Thread(new Runnable(){
	public void run() {
		BaiduPCSClientapi = new BaiduPCSClient();
		api.setAccessToken(mbOauth);
finalBaiduPCSActionInfo.PCSQuotaResponse info = api.quota();

	mbUiThreadHandler.post(new Runnable(){
public void run(){
				if(null != info){
	if(0 == info.status.errorCode){
	Toast.makeText(getApplicationContext(), "Quota :" + info.total + "  used: " + info.used, Toast.LENGTH_SHORT).show();
                            }
	else{
Toast.makeText(getApplicationContext(), "Quota failed: " + info.status.errorCode + "  " + info.status.message, Toast.LENGTH_SHORT).show();
                            }
                        }
                    }
                });
            }
        }); 

	workThread.start();
   }
}


7. 运行Android程序登录并进行授权：

pcs_106.jpg

用户单击Login按钮

8. 程序进入账号登陆界面。

pcs_101.jpg

如果用户第一次登陆第三方应用，会出现授权页面：

pcs_102.jpg

用户单击“授权”按钮之后，程序会返回主页面，在Android模拟器toast消息框里面我们就能看见获取的Access Token信息和用户名。使用此access token，我们接着来调用PCS API接口获取quota信息。

9. 用户单击“Get Quota”按钮，通过调用PCS API接口获取quota信息，获得的信息会在toast提示框中显示：

pcs_107.jpg
豫ICP备12024565号-1   E-mail:admin@hlc8.com