1<!DOCTYPE html> 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<html> 88<head> 89 90 91<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 92<meta name="viewport" content="width=device-width" /> 93 94<link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" /> 95<title>DriveContents | Android Developers</title> 96 97<!-- STYLESHEETS --> 98<link rel="stylesheet" 99href="//fonts.googleapis.com/css?family=Roboto+Condensed"> 100<link rel="stylesheet" href="//fonts.googleapis.com/css?family=Roboto:light,regular,medium,thin,italic,mediumitalic,bold" 101 title="roboto"> 102<link href="/assets/css/default.css?v=2" rel="stylesheet" type="text/css"> 103 104 105 106<!-- JAVASCRIPT --> 107<script src="//www.google.com/jsapi" type="text/javascript"></script> 108<script src="/assets/js/android_3p-bundle.js" type="text/javascript"></script> 109<script type="text/javascript"> 110 var toRoot = "/"; 111 var metaTags = []; 112 var devsite = false; 113</script> 114<script src="/assets/js/docs.js?v=2" type="text/javascript"></script> 115 116<script> 117 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ 118 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), 119 m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) 120 })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); 121 122 ga('create', 'UA-5831155-1', 'android.com'); 123 ga('create', 'UA-49880327-2', 'android.com', {'name': 'universal'}); // New tracker); 124 ga('send', 'pageview'); 125 ga('universal.send', 'pageview'); // Send page view for new tracker. 126</script> 127 128</head> 129 130<body class="gc-documentation google 131 develop" itemscope itemtype="http://schema.org/Article"> 132 <div id="doc-api-level" class="" style="display:none"></div> 133 <a name="top"></a> 134 135 136<a name="top"></a> 137 138 <!-- Header --> 139 <div id="header-wrapper"> 140 <div id="header"> 141 <div class="wrap" id="header-wrap"> 142 <div class="col-3 logo"> 143 <a href="/index.html"> 144 <img src="/assets/images/dac_logo.png" 145 srcset="/assets/images/dac_logo@2x.png 2x" 146 width="123" height="25" alt="Android Developers" /> 147 </a> 148 <div class="btn-quicknav" id="btn-quicknav"> 149 <a href="#" class="arrow-inactive">Quicknav</a> 150 <a href="#" class="arrow-active">Quicknav</a> 151 </div> 152 </div> 153 <ul class="nav-x col-9"> 154 <li class="design"> 155 <a href="/design/index.html" 156 zh-tw-lang="設計" 157 zh-cn-lang="设计" 158 ru-lang="Проектирование" 159 ko-lang="디자인" 160 ja-lang="設計" 161 es-lang="Diseñar" 162 >Design</a></li> 163 <li class="develop"><a href="/develop/index.html" 164 zh-tw-lang="開發" 165 zh-cn-lang="开发" 166 ru-lang="Разработка" 167 ko-lang="개발" 168 ja-lang="開発" 169 es-lang="Desarrollar" 170 >Develop</a></li> 171 <li class="distribute last"><a href="/distribute/index.html" 172 zh-tw-lang="發佈" 173 zh-cn-lang="分发" 174 ru-lang="Распространение" 175 ko-lang="배포" 176 ja-lang="配布" 177 es-lang="Distribuir" 178 >Distribute</a></li> 179 </ul> 180 181 182 183 184<div class="menu-container"> 185 <div class="moremenu"> 186 <div id="more-btn"></div> 187 </div> 188 <div class="morehover" id="moremenu"> 189 <div class="top"></div> 190 <div class="mid"> 191 <div class="header">Links</div> 192 <ul> 193 <li><a href="https://play.google.com/apps/publish/" target="_googleplay">Google Play Developer Console</a></li> 194 <li><a href="http://android-developers.blogspot.com/">Android Developers Blog</a></li> 195 <li><a href="/about/index.html">About Android</a></li> 196 </ul> 197 <div class="header">Android Sites</div> 198 <ul> 199 <li><a href="http://www.android.com">Android.com</a></li> 200 <li class="active"><a>Android Developers</a></li> 201 <li><a href="http://source.android.com">Android Open Source Project</a></li> 202 </ul> 203 204 205 206 <div class="header">Language</div> 207 <div id="language" class="locales"> 208 <select name="language" onChange="changeLangPref(this.value, true)"> 209 <option value="en">English</option> 210 <option value="es">Español</option> 211 <option value="ja">日本語</option> 212 <option value="ko">한국어</option> 213 <option value="ru">Русский</option> 214 <option value="zh-cn">中文 (中国)</option> 215 <option value="zh-tw">中文 (台灣)</option> 216 </select> 217 </div> 218 <script type="text/javascript"> 219 <!-- 220 loadLangPref(); 221 //--> 222 </script> 223 224 225 <br class="clearfix" /> 226 </div><!-- end 'mid' --> 227 <div class="bottom"></div> 228 </div><!-- end 'moremenu' --> 229 230 <div class="search" id="search-container"> 231 <div class="search-inner"> 232 <div id="search-btn"></div> 233 <div class="left"></div> 234 <form onsubmit="return submit_search()"> 235 <input id="search_autocomplete" type="text" value="" autocomplete="off" name="q" 236 onfocus="search_focus_changed(this, true)" onblur="search_focus_changed(this, false)" 237 onkeydown="return search_changed(event, true, '/')" 238 onkeyup="return search_changed(event, false, '/')" /> 239 </form> 240 <div class="right"></div> 241 <a class="close hide">close</a> 242 <div class="left"></div> 243 <div class="right"></div> 244 </div><!-- end search-inner --> 245 </div><!-- end search-container --> 246 247 <div class="search_filtered_wrapper reference"> 248 <div class="suggest-card reference no-display"> 249 <ul class="search_filtered"> 250 </ul> 251 </div> 252 </div> 253 254 <div class="search_filtered_wrapper docs"> 255 <div class="suggest-card dummy no-display"> </div> 256 <div class="suggest-card develop no-display"> 257 <ul class="search_filtered"> 258 </ul> 259 <div class="child-card guides no-display"> 260 </div> 261 <div class="child-card training no-display"> 262 </div> 263 <div class="child-card samples no-display"> 264 </div> 265 </div> 266 <div class="suggest-card design no-display"> 267 <ul class="search_filtered"> 268 </ul> 269 </div> 270 <div class="suggest-card distribute no-display"> 271 <ul class="search_filtered"> 272 </ul> 273 </div> 274 </div> 275</div><!-- end menu-container (search and menu widget) --> 276 277 278 279 <!-- Expanded quicknav --> 280 <div id="quicknav" class="col-13"> 281 <ul> 282 <li class="about"> 283 <ul> 284 <li><a href="/about/index.html">About</a></li> 285 <li><a href="/wear/index.html">Wear</a></li> 286 <li><a href="/tv/index.html">TV</a></li> 287 <li><a href="/auto/index.html">Auto</a></li> 288 </ul> 289 </li> 290 <li class="design"> 291 <ul> 292 <li><a href="/design/index.html">Get Started</a></li> 293 <li><a href="/design/devices.html">Devices</a></li> 294 <li><a href="/design/style/index.html">Style</a></li> 295 <li><a href="/design/patterns/index.html">Patterns</a></li> 296 <li><a href="/design/building-blocks/index.html">Building Blocks</a></li> 297 <li><a href="/design/downloads/index.html">Downloads</a></li> 298 <li><a href="/design/videos/index.html">Videos</a></li> 299 </ul> 300 </li> 301 <li class="develop"> 302 <ul> 303 <li><a href="/training/index.html" 304 zh-tw-lang="訓練課程" 305 zh-cn-lang="培训" 306 ru-lang="Курсы" 307 ko-lang="교육" 308 ja-lang="トレーニング" 309 es-lang="Capacitación" 310 >Training</a></li> 311 <li><a href="/guide/index.html" 312 zh-tw-lang="API 指南" 313 zh-cn-lang="API 指南" 314 ru-lang="Руководства по API" 315 ko-lang="API 가이드" 316 ja-lang="API ガイド" 317 es-lang="Guías de la API" 318 >API Guides</a></li> 319 <li><a href="/reference/packages.html" 320 zh-tw-lang="參考資源" 321 zh-cn-lang="参考" 322 ru-lang="Справочник" 323 ko-lang="참조문서" 324 ja-lang="リファレンス" 325 es-lang="Referencia" 326 >Reference</a></li> 327 <li><a href="/sdk/index.html" 328 zh-tw-lang="相關工具" 329 zh-cn-lang="工具" 330 ru-lang="Инструменты" 331 ko-lang="도구" 332 ja-lang="ツール" 333 es-lang="Herramientas" 334 >Tools</a> 335 </li> 336 <li><a href="/google/index.html">Google Services</a> 337 </li> 338 339 <li><a href="/samples/index.html">Samples</a> 340 </li> 341 342 </ul> 343 </li> 344 <li class="distribute last"> 345 <ul> 346 <li><a href="/distribute/googleplay/index.html">Google Play</a></li> 347 <li><a href="/distribute/essentials/index.html">Essentials</a></li> 348 <li><a href="/distribute/users/index.html">Get Users</a></li> 349 <li><a href="/distribute/engage/index.html">Engage & Retain</a></li> 350 <li><a href="/distribute/monetize/index.html">Monetize</a></li> 351 <li><a href="/distribute/tools/index.html">Tools & Reference</a></li> 352 <li><a href="/distribute/stories/index.html">Developer Stories</a></li> 353 </ul> 354 </li> 355 </ul> 356 </div><!-- /Expanded quicknav --> 357 </div><!-- end header-wrap.wrap --> 358 </div><!-- end header --> 359 360 361 <!-- Secondary x-nav --> 362 <div id="nav-x"> 363 <div class="wrap"> 364 <ul class="nav-x col-9 develop" style="width:100%"> 365 <li class="training"><a href="/training/index.html" 366 zh-tw-lang="訓練課程" 367 zh-cn-lang="培训" 368 ru-lang="Курсы" 369 ko-lang="교육" 370 ja-lang="トレーニング" 371 es-lang="Capacitación" 372 >Training</a></li> 373 <li class="guide"><a href="/guide/index.html" 374 zh-tw-lang="API 指南" 375 zh-cn-lang="API 指南" 376 ru-lang="Руководства по API" 377 ko-lang="API 가이드" 378 ja-lang="API ガイド" 379 es-lang="Guías de la API" 380 >API Guides</a></li> 381 <li class="reference"><a href="/reference/packages.html" 382 zh-tw-lang="參考資源" 383 zh-cn-lang="参考" 384 ru-lang="Справочник" 385 ko-lang="참조문서" 386 ja-lang="リファレンス" 387 es-lang="Referencia" 388 >Reference</a></li> 389 <li class="tools"><a href="/sdk/index.html" 390 zh-tw-lang="相關工具" 391 zh-cn-lang="工具" 392 ru-lang="Инструменты" 393 ko-lang="도구" 394 ja-lang="ツール" 395 es-lang="Herramientas" 396 >Tools</a></li> 397 <li class="google"><a href="/google/index.html" 398 >Google Services</a> 399 </li> 400 401 <li class="samples"><a href="/samples/index.html" 402 >Samples</a> 403 </li> 404 405 </ul> 406 </div> 407 </div> 408 <!-- /Sendondary x-nav DEVELOP --> 409 410 411 412 <div id="searchResults" class="wrap" style="display:none;"> 413 <h2 id="searchTitle">Results</h2> 414 <div id="leftSearchControl" class="search-control">Loading...</div> 415 </div> 416 </div> <!--end header-wrapper --> 417 418 <div id="sticky-header"> 419 <div> 420 <a class="logo" href="#top"></a> 421 <a class="top" href="#top"></a> 422 <ul class="breadcrumb"> 423 424 <li class="current">DriveContents</li> 425 </ul> 426 </div> 427 </div> 428 429 430 431 432 433 434 <div class="wrap clearfix" id="body-content"> 435 <div class="col-4" id="side-nav" itemscope itemtype="http://schema.org/SiteNavigationElement"> 436 <div id="devdoc-nav" class="scroll-pane"> 437 438 439 440<ul id="nav"> 441 442 <li class="nav-section"> 443 <div class="nav-section-header empty"><a href="/google/index.html"> 444 <span class="en">Overview</span> 445 </a></div> 446 </li> 447 448 <li class="nav-section"> 449 <div class="nav-section-header empty"><a href="/google/play-services/games.html"> 450 <span class="en">Games</span> 451 </a></div> 452 </li> 453 <li class="nav-section"> 454 <div class="nav-section-header empty"><a href="/google/play-services/location.html"> 455 <span class="en">Location</span> 456 </a></div> 457 </li> 458 <li class="nav-section"> 459 <div class="nav-section-header empty"><a href="/google/play-services/plus.html"> 460 <span class="en">Google+</span> 461 </a></div> 462 </li> 463 <li class="nav-section"> 464 <div class="nav-section-header empty"><a href="/google/play-services/maps.html"> 465 <span class="en">Maps</span> 466 </a></div> 467 </li> 468 <li class="nav-section"> 469 <div class="nav-section-header empty"><a href="/google/play-services/drive.html"> 470 <span class="en">Drive</span> 471 </a></div> 472 </li> 473 <li class="nav-section"> 474 <div class="nav-section-header empty"><a href="/google/play-services/cast.html"> 475 <span class="en">Cast</span> 476 </a></div> 477 </li> 478 <li class="nav-section"> 479 <div class="nav-section-header"><a href="/google/play-services/ads.html"> 480 <span class="en">Ads</span></a> 481 </div> 482 <ul> 483 <li><a href="/google/play-services/id.html"> 484 <span class="en">Advertising ID</span></a> 485 </li> 486 </ul> 487 </li> 488 <li class="nav-section"> 489 <div class="nav-section-header empty"><a href="/google/play-services/wallet.html"> 490 <span class="en">Wallet</span> 491 </a></div> 492 </li> 493 494 495 <li class="nav-section"> 496 <div class="nav-section-header"><a href="/google/play-services/index.html"> 497 <span class="en">Google Play Services</span></a> 498 </div> 499 <ul> 500 <li><a href="/google/play-services/setup.html"> 501 <span class="en">Setting Up Google Play Services</span></a> 502 </li> 503 <li class="nav-section"> 504 <div class="nav-section-header"><a href="/google/auth/api-client.html"> 505 <span class="en">Accessing Google APIs</span></a> 506 </div> 507 <ul> 508 <li> 509 <a href="/google/auth/http-auth.html"> 510 <span class="en">Authorizing with Google for REST APIs</span> 511 </a> 512 </li> 513 </ul> 514 </li> 515 <li id="gms-tree-list" class="nav-section"> 516 <div class="nav-section-header"> 517 <a href="/reference/gms-packages.html"> 518 <span class="en">Reference</span> 519 </a> 520 <div> 521 </li> 522 </ul> 523 </li> 524 525 526 <li class="nav-section"> 527 <div class="nav-section-header"><a href="/google/play/billing/index.html"> 528 <span class="en">Google Play In-app Billing</span></a> 529 </div> 530 <ul> 531 <li><a href="/google/play/billing/billing_overview.html"> 532 <span class="en">Overview</span></a> 533 </li> 534 <li class="nav-section"><div class="nav-section-header"><a href="/google/play/billing/api.html"> 535 <span class="en">Version 3 API</span></a></div> 536 <ul> 537 <li><a href="/google/play/billing/billing_integrate.html"> 538 <span class="en">Implementing the API</span></a></li> 539 <li><a href="/google/play/billing/billing_reference.html"> 540 <span class="en">Reference</span></a></li> 541 </ul> 542 </li> 543 <li class="nav-section"><div class="nav-section-header"><a href="/google/play/billing/v2/api.html"> 544 <span class="en">Version 2 API</span></a></div> 545 <ul> 546 <li><a href="/google/play/billing/v2/billing_integrate.html"> 547 <span class="en">Implementing the API</span></a></li> 548 <li><a href="/google/play/billing/v2/billing_subscriptions.html"> 549 <span class="en">Subscriptions</span></a></li> 550 <li><a href="/google/play/billing/v2/billing_reference.html"> 551 <span class="en">Reference</span></a></li> 552 </ul> 553 </li> 554 <li><a href="/google/play/billing/billing_subscriptions.html"> 555 <span class="en">Subscriptions</span></a> 556 </li> 557 <li><a href="/google/play/billing/billing_best_practices.html"> 558 <span class="en">Security and Design</span></a> 559 </li> 560 <li><a href="/google/play/billing/billing_testing.html"> 561 <span class="en">Testing In-app Billing</span></a> 562 </li> 563 <li><a href="/google/play/billing/billing_admin.html"> 564 <span class="en">Administering In-app Billing</span></a> 565 </li> 566 <li><a href="/google/play/billing/versions.html"> 567 <span class="en">Version Notes</span></a> 568 </li> 569 </ul> 570 </li> 571 572 573 574 <li class="nav-section"> 575 <div class="nav-section-header"><a href="/google/gcm/index.html"> 576 <span class="en">Google Cloud Messaging</span></a> 577 </div> 578 <ul> 579 <li><a href="/google/gcm/gcm.html"> 580 <span class="en">Overview</span></a> 581 </li> 582 <li><a href="/google/gcm/gs.html"> 583 <span class="en">Getting Started</span></a> 584 </li> 585 <li><a href="/google/gcm/client.html"> 586 <span class="en">Implementing GCM Client</span></a> 587 </li> 588 <li class="nav-section"><div class="nav-section-header"><a href="/google/gcm/server.html"> 589 <span class="en">Implementing GCM Server</span></a></div> 590 <ul> 591 <li><a href="/google/gcm/ccs.html"> 592 <span class="en">CCS (XMPP)</span></a></li> 593 <li><a href="/google/gcm/http.html"> 594 <span class="en">HTTP</span></a></li> 595 </ul> 596 </li> 597 <li><a href="/google/gcm/notifications.html"> 598 <span class="en">User Notifications</span></a> 599 </li> 600 <li><a href="/google/gcm/adv.html"> 601 <span class="en">Advanced Topics</span></a> 602 </li> 603 <li><a href="/google/gcm/c2dm.html"> 604 <span class="en">Migration</span></a> 605 </li> 606 <li id="gcm-tree-list" class="nav-section"> 607 <div class="nav-section-header"> 608 <a href="/reference/gcm-packages.html"> 609 <span class="en">Reference</span> 610 </a> 611 <div> 612 </li> 613 </ul> 614 </li> 615 616 <li class="nav-section"> 617 <div class="nav-section-header empty"><a href="/google/gcs/index.html"> 618 <span class="en">Google Cloud Save</span></a> 619 </div> 620 </li> 621 622 <li class="nav-section"> 623 <div class="nav-section-header"><a href="/google/play/dist.html"> 624 <span class="en">Google Play Distribution</span></a> 625 </div> 626 <ul> 627 <li><a href="/google/play/filters.html"> 628 <span class="en">Filters on Google Play</span></a> 629 </li> 630 <li><a href="/google/play/billing/gp-purchase-status-api.html"> 631 <span class="en">Google Play Developer API</span></a> 632 </li> 633 <li><a href="/google/play/publishing/multiple-apks.html"> 634 <span class="en">Multiple APK Support</span></a> 635 </li> 636 <li><a href="/google/play/expansion-files.html"> 637 <span class="en">APK Expansion Files</span></a> 638 </li> 639 <li class="nav-section"> 640 <div class="nav-section-header"><a href="/google/play/licensing/index.html"> 641 <span class="en">Application Licensing</span></a> 642 </div> 643 <ul> 644 <li><a href="/google/play/licensing/overview.html"> 645 <span class="en">Licensing Overview</span></a> 646 </li> 647 <li><a href="/google/play/licensing/setting-up.html"> 648 <span class="en">Setting Up for Licensing</span></a> 649 </li> 650 <li><a href="/google/play/licensing/adding-licensing.html"> 651 <span class="en">Adding Licensing to Your App</span></a> 652 </li> 653 <li><a href="/google/play/licensing/licensing-reference.html"> 654 <span class="en">Licensing Reference</span></a> 655 </li> 656 </ul> 657 </li> 658 659 <li class="nav-section"> 660 <div class="nav-section-header"><a href="/google/backup/index.html"> 661 Android Backup Service</a> 662 </div> 663 <ul> 664 <li><a href="/google/backup/signup.html"> 665 Register</a> 666 </li> 667 </ul> 668 </li> 669 670 </ul> 671 672</li> 673 674 675 676</ul> 677 678<script type="text/javascript"> 679<!-- 680 buildToggleLists(); 681 changeNavLang(getLangPref()); 682//--> 683</script> 684 685 686 687 688 </div> 689 <script type="text/javascript"> 690 showGoogleRefTree(); 691 692 </script> 693 </div> <!-- end side-nav --> 694 <script> 695 $(document).ready(function() { 696 scrollIntoView("devdoc-nav"); 697 }); 698 </script> 699 700 701 702 703 704 705<div class="col-12" id="doc-col"> 706 707<div id="api-info-block"> 708 709 710 711 712<div class="sum-details-links"> 713 714</div><!-- end sum-details-links --> 715<div class="api-level"> 716 717 718 719 720</div> 721</div><!-- end api-info-block --> 722 723 724<!-- ======== START OF CLASS DATA ======== --> 725 726<div id="jd-header"> 727 public 728 729 730 731 interface 732<h1 itemprop="name">DriveContents</h1> 733 734 735 736 737 738 739 740 741</div><!-- end header --> 742 743<div id="naMessage"></div> 744 745<div id="jd-content" class="api apilevel-"> 746<table class="jd-inheritance-table"> 747 748 749 <tr> 750 751 <td colspan="1" class="jd-inheritance-class-cell">com.google.android.gms.drive.DriveContents</td> 752 </tr> 753 754 755</table> 756 757 758 759 760 761 762 763<div class="jd-descr"> 764 765 766<h2>Class Overview</h2> 767<p itemprop="articleBody">A reference to a Drive file's contents. There are two types of <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code>: 768 <ul> 769 <li>Contents already associated to an existing <code><a href="/reference/com/google/android/gms/drive/DriveFile.html">DriveFile</a></code>. This type is obtained through 770 <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#open(com.google.android.gms.common.api.GoogleApiClient, int, com.google.android.gms.drive.DriveFile.DownloadProgressListener)">open(GoogleApiClient, int, DriveFile.DownloadProgressListener)</a></code>. 771 <li>Contents not associated to any file and used only when creating a new file. This type is 772 obtained through <code><a href="/reference/com/google/android/gms/drive/DriveApi.html#newDriveContents(com.google.android.gms.common.api.GoogleApiClient)">newDriveContents(GoogleApiClient)</a></code>. 773 </ul> 774 775 <p> 776 Any changes made to the <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> through either their <code><a href="/reference/android/os/ParcelFileDescriptor.html">ParcelFileDescriptor</a></code> 777 or <code><a href="/reference/java/io/OutputStream.html">OutputStream</a></code> will not be visible until either <code><a href="/reference/com/google/android/gms/drive/DriveContents.html#commit(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.drive.MetadataChangeSet)">commit(GoogleApiClient, MetadataChangeSet)</a></code> is executed (for 778 existing contents already associated to a <code><a href="/reference/com/google/android/gms/drive/DriveFile.html">DriveFile</a></code>), or a new file is created using this 779 contents (through <code><a href="/reference/com/google/android/gms/drive/DriveFolder.html#createFile(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.drive.MetadataChangeSet, com.google.android.gms.drive.Contents)">createFile(GoogleApiClient, MetadataChangeSet, Contents)</a></code> or <code><a href="/reference/com/google/android/gms/drive/CreateFileActivityBuilder.html">CreateFileActivityBuilder</a></code>, for new 780 contents). 781 782 <p> 783 In both cases, the <code><a href="/reference/com/google/android/gms/drive/DriveContents.html#discard(com.google.android.gms.common.api.GoogleApiClient)">discard(GoogleApiClient)</a></code> method can be used to discard any changes to any kind of 784 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code>, so those changes will never be applied to a <code><a href="/reference/com/google/android/gms/drive/DriveFile.html">DriveFile</a></code> or persisted 785 in Drive. 786 787 <p> 788 Once this <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> instance has been committed, used for creation, or discarded, it 789 becomes closed and any subsequent method call will throw an <code><a href="/reference/java/lang/IllegalStateException.html">IllegalStateException</a></code>. 790</p> 791 792 793 794 795 796</div><!-- jd-descr --> 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813<div class="jd-descr"> 814 815 816<h2>Summary</h2> 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844<!-- ========== METHOD SUMMARY =========== --> 845<table id="pubmethods" class="jd-sumtable"><tr><th colspan="12">Public Methods</th></tr> 846 847 848 849 850 <tr class="alt-color api apilevel-" > 851 <td class="jd-typecol"><nobr> 852 abstract 853 854 855 856 857 <a href="/reference/com/google/android/gms/common/api/PendingResult.html">PendingResult</a><<a href="/reference/com/google/android/gms/common/api/Status.html">Status</a>></nobr> 858 </td> 859 <td class="jd-linkcol" width="100%"><nobr> 860 <span class="sympad"><a href="/reference/com/google/android/gms/drive/DriveContents.html#commit(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.drive.MetadataChangeSet, com.google.android.gms.drive.ExecutionOptions)">commit</a></span>(<a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a> apiClient, <a href="/reference/com/google/android/gms/drive/MetadataChangeSet.html">MetadataChangeSet</a> changeSet, <a href="/reference/com/google/android/gms/drive/ExecutionOptions.html">ExecutionOptions</a> executionOptions)</nobr> 861 862 <div class="jd-descrdiv">Advanced version of commit which commits this contents and updates the metadata (if provided) 863 of the file associated to this <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> instance and allows the client to 864 specify a conflict resolution strategy or request completion notifications via the 865 <code>executionOptions</code> parameter.</div> 866 867 </td></tr> 868 869 870 871 <tr class=" api apilevel-" > 872 <td class="jd-typecol"><nobr> 873 abstract 874 875 876 877 878 <a href="/reference/com/google/android/gms/common/api/PendingResult.html">PendingResult</a><<a href="/reference/com/google/android/gms/common/api/Status.html">Status</a>></nobr> 879 </td> 880 <td class="jd-linkcol" width="100%"><nobr> 881 <span class="sympad"><a href="/reference/com/google/android/gms/drive/DriveContents.html#commit(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.drive.MetadataChangeSet)">commit</a></span>(<a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a> apiClient, <a href="/reference/com/google/android/gms/drive/MetadataChangeSet.html">MetadataChangeSet</a> changeSet)</nobr> 882 883 <div class="jd-descrdiv">Commits this contents and updates the metadata (if provided) of the file associated to this 884 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> instance.</div> 885 886 </td></tr> 887 888 889 890 <tr class="alt-color api apilevel-" > 891 <td class="jd-typecol"><nobr> 892 abstract 893 894 895 896 897 void</nobr> 898 </td> 899 <td class="jd-linkcol" width="100%"><nobr> 900 <span class="sympad"><a href="/reference/com/google/android/gms/drive/DriveContents.html#discard(com.google.android.gms.common.api.GoogleApiClient)">discard</a></span>(<a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a> apiClient)</nobr> 901 902 <div class="jd-descrdiv">Discards this contents and any changes that were performed.</div> 903 904 </td></tr> 905 906 907 908 <tr class=" api apilevel-" > 909 <td class="jd-typecol"><nobr> 910 abstract 911 912 913 914 915 <a href="/reference/com/google/android/gms/drive/DriveId.html">DriveId</a></nobr> 916 </td> 917 <td class="jd-linkcol" width="100%"><nobr> 918 <span class="sympad"><a href="/reference/com/google/android/gms/drive/DriveContents.html#getDriveId()">getDriveId</a></span>()</nobr> 919 920 <div class="jd-descrdiv">Gets the <code><a href="/reference/com/google/android/gms/drive/DriveId.html">DriveId</a></code> for the file that owns these contents.</div> 921 922 </td></tr> 923 924 925 926 <tr class="alt-color api apilevel-" > 927 <td class="jd-typecol"><nobr> 928 abstract 929 930 931 932 933 InputStream</nobr> 934 </td> 935 <td class="jd-linkcol" width="100%"><nobr> 936 <span class="sympad"><a href="/reference/com/google/android/gms/drive/DriveContents.html#getInputStream()">getInputStream</a></span>()</nobr> 937 938 <div class="jd-descrdiv">Returns an <code><a href="/reference/java/io/InputStream.html">InputStream</a></code> that allows you to read this file's contents.</div> 939 940 </td></tr> 941 942 943 944 <tr class=" api apilevel-" > 945 <td class="jd-typecol"><nobr> 946 abstract 947 948 949 950 951 int</nobr> 952 </td> 953 <td class="jd-linkcol" width="100%"><nobr> 954 <span class="sympad"><a href="/reference/com/google/android/gms/drive/DriveContents.html#getMode()">getMode</a></span>()</nobr> 955 956 <div class="jd-descrdiv">Gets the mode the contents are opened in.</div> 957 958 </td></tr> 959 960 961 962 <tr class="alt-color api apilevel-" > 963 <td class="jd-typecol"><nobr> 964 abstract 965 966 967 968 969 OutputStream</nobr> 970 </td> 971 <td class="jd-linkcol" width="100%"><nobr> 972 <span class="sympad"><a href="/reference/com/google/android/gms/drive/DriveContents.html#getOutputStream()">getOutputStream</a></span>()</nobr> 973 974 <div class="jd-descrdiv">Returns an <code><a href="/reference/java/io/OutputStream.html">OutputStream</a></code> that allows you to write new contents.</div> 975 976 </td></tr> 977 978 979 980 <tr class=" api apilevel-" > 981 <td class="jd-typecol"><nobr> 982 abstract 983 984 985 986 987 ParcelFileDescriptor</nobr> 988 </td> 989 <td class="jd-linkcol" width="100%"><nobr> 990 <span class="sympad"><a href="/reference/com/google/android/gms/drive/DriveContents.html#getParcelFileDescriptor()">getParcelFileDescriptor</a></span>()</nobr> 991 992 <div class="jd-descrdiv">Returns a <code><a href="/reference/android/os/ParcelFileDescriptor.html">ParcelFileDescriptor</a></code> that points to the Drive file's contents.</div> 993 994 </td></tr> 995 996 997 998 <tr class="alt-color api apilevel-" > 999 <td class="jd-typecol"><nobr> 1000 abstract 1001 1002 1003 1004 1005 <a href="/reference/com/google/android/gms/common/api/PendingResult.html">PendingResult</a><<a href="/reference/com/google/android/gms/drive/DriveApi.DriveContentsResult.html">DriveApi.DriveContentsResult</a>></nobr> 1006 </td> 1007 <td class="jd-linkcol" width="100%"><nobr> 1008 <span class="sympad"><a href="/reference/com/google/android/gms/drive/DriveContents.html#reopenForWrite(com.google.android.gms.common.api.GoogleApiClient)">reopenForWrite</a></span>(<a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a> apiClient)</nobr> 1009 1010 <div class="jd-descrdiv">Closes this contents and returns a new contents opened in <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_WRITE_ONLY">MODE_WRITE_ONLY</a></code>.</div> 1011 1012 </td></tr> 1013 1014 1015 1016</table> 1017 1018 1019 1020 1021 1022 1023 1024</div><!-- jd-descr (summary) --> 1025 1026<!-- Details --> 1027 1028 1029 1030 1031 1032 1033 1034 1035<!-- XML Attributes --> 1036 1037 1038<!-- Enum Values --> 1039 1040 1041<!-- Constants --> 1042 1043 1044<!-- Fields --> 1045 1046 1047<!-- Public ctors --> 1048 1049 1050 1051<!-- ========= CONSTRUCTOR DETAIL ======== --> 1052<!-- Protected ctors --> 1053 1054 1055 1056<!-- ========= METHOD DETAIL ======== --> 1057<!-- Public methdos --> 1058 1059<h2>Public Methods</h2> 1060 1061 1062 1063<A NAME="commit(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.drive.MetadataChangeSet, com.google.android.gms.drive.ExecutionOptions)"></A> 1064 1065<div class="jd-details api apilevel-"> 1066 <h4 class="jd-details-title"> 1067 <span class="normal"> 1068 public 1069 1070 1071 abstract 1072 1073 <a href="/reference/com/google/android/gms/common/api/PendingResult.html">PendingResult</a><<a href="/reference/com/google/android/gms/common/api/Status.html">Status</a>> 1074 </span> 1075 <span class="sympad">commit</span> 1076 <span class="normal">(<a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a> apiClient, <a href="/reference/com/google/android/gms/drive/MetadataChangeSet.html">MetadataChangeSet</a> changeSet, <a href="/reference/com/google/android/gms/drive/ExecutionOptions.html">ExecutionOptions</a> executionOptions)</span> 1077 </h4> 1078 <div class="api-level"> 1079 <div></div> 1080 1081 1082 1083 </div> 1084 <div class="jd-details-descr"> 1085 1086 <div class="jd-tagdata jd-tagdescr"><p>Advanced version of commit which commits this contents and updates the metadata (if provided) 1087 of the file associated to this <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> instance and allows the client to 1088 specify a conflict resolution strategy or request completion notifications via the 1089 <code>executionOptions</code> parameter. 1090 1091 <p> 1092 A file conflict happens when the written contents are not applied on top of the file revision 1093 that Drive originally provided when the contents were read by the application. A conflict 1094 could happen when an application reads contents at revision X, then writes revision X+1 and 1095 by the time X+1 is committed (or uploaded to the server), the file version is not X anymore 1096 (another app or a remote change already modified the file to revision X'). 1097 1098 <p> 1099 This method should only be used on <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> that are already associated to a 1100 particular file. See <code><a href="/reference/com/google/android/gms/drive/ExecutionOptions.Builder.html#setConflictStrategy(int)">setConflictStrategy(int)</a></code> for 1101 details on using each conflict strategy. 1102 1103 <p> 1104 After this method returns, this instance will be closed and will no longer be usable.</p></div> 1105 <div class="jd-tagdata"> 1106 <h5 class="jd-tagtitle">Parameters</h5> 1107 <table class="jd-tagtable"> 1108 <tr> 1109 <th>apiClient</td> 1110 <td>The <code><a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a></code> to service the call. The client must be 1111 connected before invoking this method.</td> 1112 </tr> 1113 <tr> 1114 <th>changeSet</td> 1115 <td>The set of changes that will be applied to the Metadata of the file 1116 associated to this contents instance. Should only include the specific fields that should 1117 be updated. Can be <code>null</code> if no metadata changes should be applied with this 1118 commit.</td> 1119 </tr> 1120 <tr> 1121 <th>executionOptions</td> 1122 <td>Contains any extra settings for this commit action, such as the 1123 strategy for handling conflicts or whether the client should be notified of failures when 1124 applying this operation on the server. See <code><a href="/reference/com/google/android/gms/drive/ExecutionOptions.html">ExecutionOptions</a></code> for more info.</td> 1125 </tr> 1126 </table> 1127 </div> 1128 <div class="jd-tagdata"> 1129 <h5 class="jd-tagtitle">Returns</h5> 1130 <ul class="nolist"><li>A <code><a href="/reference/com/google/android/gms/common/api/PendingResult.html">PendingResult</a></code> which can be used to verify the success of the operation.</li></ul> 1131 </div> 1132 <div class="jd-tagdata"> 1133 <h5 class="jd-tagtitle">Throws</h5> 1134 <table class="jd-tagtable"> 1135 <tr> 1136 <th>IllegalStateException</td> 1137 <td>If one of the following is true: 1138 <ul> 1139 <li>This DriveContents was opened in <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_ONLY">MODE_READ_ONLY</a></code>. 1140 <li>This DriveContents is not associated to a file (obtained through 1141 <code><a href="/reference/com/google/android/gms/drive/DriveApi.html#newDriveContents(com.google.android.gms.common.api.GoogleApiClient)">newDriveContents(GoogleApiClient)</a></code>)). 1142 <li>The specified <code><a href="/reference/com/google/android/gms/drive/ExecutionOptions.html">ExecutionOptions</a></code> is incompatible with this DriveContents. 1143 </ul> 1144</td> 1145 </tr> 1146 </table> 1147 </div> 1148 1149 </div> 1150</div> 1151 1152 1153<A NAME="commit(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.drive.MetadataChangeSet)"></A> 1154 1155<div class="jd-details api apilevel-"> 1156 <h4 class="jd-details-title"> 1157 <span class="normal"> 1158 public 1159 1160 1161 abstract 1162 1163 <a href="/reference/com/google/android/gms/common/api/PendingResult.html">PendingResult</a><<a href="/reference/com/google/android/gms/common/api/Status.html">Status</a>> 1164 </span> 1165 <span class="sympad">commit</span> 1166 <span class="normal">(<a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a> apiClient, <a href="/reference/com/google/android/gms/drive/MetadataChangeSet.html">MetadataChangeSet</a> changeSet)</span> 1167 </h4> 1168 <div class="api-level"> 1169 <div></div> 1170 1171 1172 1173 </div> 1174 <div class="jd-details-descr"> 1175 1176 <div class="jd-tagdata jd-tagdescr"><p>Commits this contents and updates the metadata (if provided) of the file associated to this 1177 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> instance. This method should only be used on <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> that 1178 are already associated to a particular file (obtained through <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#open(com.google.android.gms.common.api.GoogleApiClient, int, com.google.android.gms.drive.DriveFile.DownloadProgressListener)">open(GoogleApiClient, int, DriveFile.DownloadProgressListener)</a></code>). 1179 1180 <p> 1181 This method behaves like 1182 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html#commit(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.drive.MetadataChangeSet, com.google.android.gms.drive.ExecutionOptions)">commit(GoogleApiClient, MetadataChangeSet, ExecutionOptions)</a></code> with the 1183 <code><a href="/reference/com/google/android/gms/drive/ExecutionOptions.html">ExecutionOptions</a></code> having a <code><a href="/reference/com/google/android/gms/drive/ExecutionOptions.html#CONFLICT_STRATEGY_OVERWRITE_REMOTE">CONFLICT_STRATEGY_OVERWRITE_REMOTE</a></code> 1184 strategy, no completion event requested and no operation tag. Use the advanced version of 1185 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html#commit(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.drive.MetadataChangeSet, com.google.android.gms.drive.ExecutionOptions)">commit</a></code> if you'd like to 1186 specify different <code><a href="/reference/com/google/android/gms/drive/ExecutionOptions.html">ExecutionOptions</a></code>. 1187 1188 <p> 1189 After this method returns, this instance will be closed and will no longer be usable.</p></div> 1190 <div class="jd-tagdata"> 1191 <h5 class="jd-tagtitle">Parameters</h5> 1192 <table class="jd-tagtable"> 1193 <tr> 1194 <th>apiClient</td> 1195 <td>The <code><a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a></code> to service the call. The client must be 1196 connected before invoking this method.</td> 1197 </tr> 1198 <tr> 1199 <th>changeSet</td> 1200 <td>The set of changes that will be applied to the Metadata of the file 1201 associated to this contents instance. Should only include the specific fields that should 1202 be updated. Can be <code>null</code> if no metadata changes should be applied with this 1203 commit.</td> 1204 </tr> 1205 </table> 1206 </div> 1207 <div class="jd-tagdata"> 1208 <h5 class="jd-tagtitle">Returns</h5> 1209 <ul class="nolist"><li>A <code><a href="/reference/com/google/android/gms/common/api/PendingResult.html">PendingResult</a></code> which can be used to verify the success of the operation.</li></ul> 1210 </div> 1211 <div class="jd-tagdata"> 1212 <h5 class="jd-tagtitle">Throws</h5> 1213 <table class="jd-tagtable"> 1214 <tr> 1215 <th>IllegalStateException</td> 1216 <td>If one of the following is true: 1217 <ul> 1218 <li>This DriveContents was opened in <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_ONLY">MODE_READ_ONLY</a></code>. 1219 <li>This DriveContents is not associated to a file (obtained through 1220 <code><a href="/reference/com/google/android/gms/drive/DriveApi.html#newDriveContents(com.google.android.gms.common.api.GoogleApiClient)">newDriveContents(GoogleApiClient)</a></code>)). 1221 </ul> 1222</td> 1223 </tr> 1224 </table> 1225 </div> 1226 1227 </div> 1228</div> 1229 1230 1231<A NAME="discard(com.google.android.gms.common.api.GoogleApiClient)"></A> 1232 1233<div class="jd-details api apilevel-"> 1234 <h4 class="jd-details-title"> 1235 <span class="normal"> 1236 public 1237 1238 1239 abstract 1240 1241 void 1242 </span> 1243 <span class="sympad">discard</span> 1244 <span class="normal">(<a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a> apiClient)</span> 1245 </h4> 1246 <div class="api-level"> 1247 <div></div> 1248 1249 1250 1251 </div> 1252 <div class="jd-details-descr"> 1253 1254 <div class="jd-tagdata jd-tagdescr"><p>Discards this contents and any changes that were performed. Calling this method will not save 1255 any changes performed through this object. 1256 1257 <p> 1258 After this method returns, this instance will be closed and will no longer be usable.</p></div> 1259 <div class="jd-tagdata"> 1260 <h5 class="jd-tagtitle">Parameters</h5> 1261 <table class="jd-tagtable"> 1262 <tr> 1263 <th>apiClient</td> 1264 <td>The <code><a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a></code> to service the call. The client must be 1265 connected before invoking this method. 1266</td> 1267 </tr> 1268 </table> 1269 </div> 1270 1271 </div> 1272</div> 1273 1274 1275<A NAME="getDriveId()"></A> 1276 1277<div class="jd-details api apilevel-"> 1278 <h4 class="jd-details-title"> 1279 <span class="normal"> 1280 public 1281 1282 1283 abstract 1284 1285 <a href="/reference/com/google/android/gms/drive/DriveId.html">DriveId</a> 1286 </span> 1287 <span class="sympad">getDriveId</span> 1288 <span class="normal">()</span> 1289 </h4> 1290 <div class="api-level"> 1291 <div></div> 1292 1293 1294 1295 </div> 1296 <div class="jd-details-descr"> 1297 1298 <div class="jd-tagdata jd-tagdescr"><p>Gets the <code><a href="/reference/com/google/android/gms/drive/DriveId.html">DriveId</a></code> for the file that owns these contents. Will be <code>null</code> if this 1299 instance corresponds to new contents (obtained through <code><a href="/reference/com/google/android/gms/drive/DriveApi.html#newDriveContents(com.google.android.gms.common.api.GoogleApiClient)">newDriveContents(GoogleApiClient)</a></code>}. 1300</p></div> 1301 1302 </div> 1303</div> 1304 1305 1306<A NAME="getInputStream()"></A> 1307 1308<div class="jd-details api apilevel-"> 1309 <h4 class="jd-details-title"> 1310 <span class="normal"> 1311 public 1312 1313 1314 abstract 1315 1316 InputStream 1317 </span> 1318 <span class="sympad">getInputStream</span> 1319 <span class="normal">()</span> 1320 </h4> 1321 <div class="api-level"> 1322 <div></div> 1323 1324 1325 1326 </div> 1327 <div class="jd-details-descr"> 1328 1329 <div class="jd-tagdata jd-tagdescr"><p>Returns an <code><a href="/reference/java/io/InputStream.html">InputStream</a></code> that allows you to read this file's contents. This method may 1330 only be used with files opened with <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_ONLY">MODE_READ_ONLY</a></code>; to read/write from a 1331 file opened with <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_WRITE">MODE_READ_WRITE</a></code>, use the file descriptor returned by 1332 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html#getParcelFileDescriptor()">getParcelFileDescriptor()</a></code>. This method may only be called once per 1333 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> instance. 1334</p></div> 1335 1336 </div> 1337</div> 1338 1339 1340<A NAME="getMode()"></A> 1341 1342<div class="jd-details api apilevel-"> 1343 <h4 class="jd-details-title"> 1344 <span class="normal"> 1345 public 1346 1347 1348 abstract 1349 1350 int 1351 </span> 1352 <span class="sympad">getMode</span> 1353 <span class="normal">()</span> 1354 </h4> 1355 <div class="api-level"> 1356 <div></div> 1357 1358 1359 1360 </div> 1361 <div class="jd-details-descr"> 1362 1363 <div class="jd-tagdata jd-tagdescr"><p>Gets the mode the contents are opened in. 1364</p></div> 1365 1366 </div> 1367</div> 1368 1369 1370<A NAME="getOutputStream()"></A> 1371 1372<div class="jd-details api apilevel-"> 1373 <h4 class="jd-details-title"> 1374 <span class="normal"> 1375 public 1376 1377 1378 abstract 1379 1380 OutputStream 1381 </span> 1382 <span class="sympad">getOutputStream</span> 1383 <span class="normal">()</span> 1384 </h4> 1385 <div class="api-level"> 1386 <div></div> 1387 1388 1389 1390 </div> 1391 <div class="jd-details-descr"> 1392 1393 <div class="jd-tagdata jd-tagdescr"><p>Returns an <code><a href="/reference/java/io/OutputStream.html">OutputStream</a></code> that allows you to write new contents. This method may only 1394 be used with files opened with <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_WRITE_ONLY">MODE_WRITE_ONLY</a></code>; to read/write from a file 1395 opened with <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_WRITE">MODE_READ_WRITE</a></code>, use the file descriptor returned by 1396 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html#getParcelFileDescriptor()">getParcelFileDescriptor()</a></code>. This method may only be called once per 1397 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> instance. 1398</p></div> 1399 1400 </div> 1401</div> 1402 1403 1404<A NAME="getParcelFileDescriptor()"></A> 1405 1406<div class="jd-details api apilevel-"> 1407 <h4 class="jd-details-title"> 1408 <span class="normal"> 1409 public 1410 1411 1412 abstract 1413 1414 ParcelFileDescriptor 1415 </span> 1416 <span class="sympad">getParcelFileDescriptor</span> 1417 <span class="normal">()</span> 1418 </h4> 1419 <div class="api-level"> 1420 <div></div> 1421 1422 1423 1424 </div> 1425 <div class="jd-details-descr"> 1426 1427 <div class="jd-tagdata jd-tagdescr"><p>Returns a <code><a href="/reference/android/os/ParcelFileDescriptor.html">ParcelFileDescriptor</a></code> that points to the Drive file's contents. If this file 1428 was opened with <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_ONLY">MODE_READ_ONLY</a></code> or <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_WRITE">MODE_READ_WRITE</a></code>, the 1429 file referenced by the returned file descriptor will contain the most recent version of the 1430 file. Otherwise, the returned file descriptor will point to an empty file. 1431</p></div> 1432 1433 </div> 1434</div> 1435 1436 1437<A NAME="reopenForWrite(com.google.android.gms.common.api.GoogleApiClient)"></A> 1438 1439<div class="jd-details api apilevel-"> 1440 <h4 class="jd-details-title"> 1441 <span class="normal"> 1442 public 1443 1444 1445 abstract 1446 1447 <a href="/reference/com/google/android/gms/common/api/PendingResult.html">PendingResult</a><<a href="/reference/com/google/android/gms/drive/DriveApi.DriveContentsResult.html">DriveApi.DriveContentsResult</a>> 1448 </span> 1449 <span class="sympad">reopenForWrite</span> 1450 <span class="normal">(<a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a> apiClient)</span> 1451 </h4> 1452 <div class="api-level"> 1453 <div></div> 1454 1455 1456 1457 </div> 1458 <div class="jd-details-descr"> 1459 1460 <div class="jd-tagdata jd-tagdescr"><p>Closes this contents and returns a new contents opened in <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_WRITE_ONLY">MODE_WRITE_ONLY</a></code>. 1461 The returned <code><a href="/reference/com/google/android/gms/drive/DriveContents.html">DriveContents</a></code> are usable for conflict detection. 1462 1463 <p> 1464 This method can only be called on <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_ONLY">MODE_READ_ONLY</a></code> contents. Calling it on 1465 <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_WRITE_ONLY">MODE_WRITE_ONLY</a></code> or <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_WRITE">MODE_READ_WRITE</a></code> contents, or on closed 1466 contents throws an <code><a href="/reference/java/lang/IllegalStateException.html">IllegalStateException</a></code>. 1467 1468 <p> 1469 This method is useful for conflict detection, and often used in conjunction with 1470 <code><a href="/reference/com/google/android/gms/drive/DriveContents.html#commit(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.drive.MetadataChangeSet, com.google.android.gms.drive.ExecutionOptions)">commit(GoogleApiClient, MetadataChangeSet, ExecutionOptions)</a></code>, however it can also 1471 be used to open contents in <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_WRITE_ONLY">MODE_WRITE_ONLY</a></code> from an existing instance of 1472 <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_READ_ONLY">MODE_READ_ONLY</a></code> contents. 1473 1474 <p> 1475 After this method returns, this instance will be closed and will no longer be usable.</p></div> 1476 <div class="jd-tagdata"> 1477 <h5 class="jd-tagtitle">Parameters</h5> 1478 <table class="jd-tagtable"> 1479 <tr> 1480 <th>apiClient</td> 1481 <td>The <code><a href="/reference/com/google/android/gms/common/api/GoogleApiClient.html">GoogleApiClient</a></code> to service the call.</td> 1482 </tr> 1483 </table> 1484 </div> 1485 <div class="jd-tagdata"> 1486 <h5 class="jd-tagtitle">Returns</h5> 1487 <ul class="nolist"><li>A <code><a href="/reference/com/google/android/gms/common/api/PendingResult.html">PendingResult</a></code> which can be used to verify the success of the operation and 1488 retrieve the <code><a href="/reference/com/google/android/gms/drive/DriveFile.html#MODE_WRITE_ONLY">MODE_WRITE_ONLY</a></code> Contents when they are ready. 1489</li></ul> 1490 </div> 1491 1492 </div> 1493</div> 1494 1495 1496 1497 1498 1499<!-- ========= METHOD DETAIL ======== --> 1500 1501 1502 1503<!-- ========= END OF CLASS DATA ========= --> 1504<A NAME="navbar_top"></A> 1505 1506<div id="footer" class="wrap" > 1507 1508 1509 <div id="copyright"> 1510 1511 Except as noted, this content is licensed under <a 1512 href="http://www.apache.org/licenses/LICENSE-2.0">Apache 2.0</a>. 1513 For details and restrictions, see the <a href="/license.html"> 1514 Content License</a>. 1515 </div> 1516 <div id="build_info"> 1517 1518<script src="/timestamp.js" type="text/javascript"></script> 1519<script>document.write(BUILD_TIMESTAMP)</script> 1520 1521 </div> 1522 1523 1524 <div id="footerlinks"> 1525 1526 <p> 1527 <a href="/about/index.html">About Android</a> | 1528 <a href="/legal.html">Legal</a> | 1529 <a href="/support.html">Support</a> 1530 </p> 1531 </div> 1532 1533</div> <!-- end footer --> 1534</div> <!-- jd-content --> 1535 1536</div><!-- end doc-content --> 1537 1538</div> <!-- end body-content --> 1539 1540 1541 1542 1543 1544 1545</body> 1546</html> 1547
