import com.google.gdata.data.Link; //导入依赖的package包/类
private void updateWorksheetWithAllItems(WorksheetEntry worksheet, String[] header, List<ReportItem> reportItems, int numberOfRows, int numberOfColumns, String reportSpreadsheetName)
        throws BatchInterruptedException, MalformedURLException, IOException, ServiceException
{
    URL cellFeedUrl = worksheet.getCellFeedUrl();
    CellFeed cellFeed = spreadsheetService.getFeed(cellFeedUrl, CellFeed.class);

    Map<String, CellEntry> cellEntries = prepareBatchByQueringWorksheet(cellFeedUrl, numberOfRows, numberOfColumns);

    int startingRow = 1;
    int rowsInBatch = ((Double) Math.ceil((double)numberOfRows / Properties.googleSheetsBatchUploadSizeSplitFactor.get())).intValue();
    int endingRow = rowsInBatch;
    for (int i = 0; i < Properties.googleSheetsBatchUploadSizeSplitFactor.get(); i++) {
        CellFeed batchRequest = createBatchRequest(header, reportItems, startingRow, endingRow, numberOfColumns, cellEntries);
        Link batchLink = cellFeed.getLink(Link.Rel.FEED_BATCH, Link.Type.ATOM);
        CellFeed batchResponse = spreadsheetService.batch(new URL(batchLink.getHref()), batchRequest);
        boolean isSuccess = checkResults(batchResponse);
        logger.info((isSuccess ? "Batch operations successful: " : "Batch operations failed: ") + reportSpreadsheetName + " " + worksheet.getTitle().getPlainText() + " starting row: " + startingRow +", through row: " + endingRow);
        startingRow = startingRow + rowsInBatch;
        endingRow = Math.min(numberOfRows, endingRow + rowsInBatch);
    }
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
private Map<String, CellEntry> prepareBatchByQueringWorksheet(URL cellFeedUrl, int numberOfRows, int numberOfColumns) throws IOException, ServiceException
{
    CellFeed batchRequest = new CellFeed();
    for (int rowIndex = 1; rowIndex <= numberOfRows; rowIndex++) {
        for (int columnIndex = 1; columnIndex <= numberOfColumns; columnIndex++) {
            String id = getR1C1Id(rowIndex, columnIndex);
            CellEntry batchEntry = new CellEntry(rowIndex, columnIndex, id);
            batchEntry.setId(String.format("%s/%s", cellFeedUrl.toString(), id));
            BatchUtils.setBatchId(batchEntry, id);
            BatchUtils.setBatchOperationType(batchEntry, BatchOperationType.QUERY);
            batchRequest.getEntries().add(batchEntry);
        }
    }

    CellFeed cellFeed = spreadsheetService.getFeed(cellFeedUrl, CellFeed.class);
    CellFeed queryBatchResponse = spreadsheetService.batch(new URL(cellFeed.getLink(Link.Rel.FEED_BATCH, Link.Type.ATOM).getHref()), batchRequest);

    Map<String, CellEntry> cellEntryMap = new HashMap<String, CellEntry>(numberOfColumns);
    for (CellEntry entry : queryBatchResponse.getEntries()) {
        cellEntryMap.put(BatchUtils.getBatchId(entry), entry);
    }
    return cellEntryMap;
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Retrieves all users in domain.  This method may be very slow for domains
 * with a large number of users.  Any changes to users, including creations
 * and deletions, which are made after this method is called may or may not be
 * included in the Feed which is returned.
 *
 * @return A UserFeed object of the retrieved users.
 * @throws AppsForYourDomainException If a Provisioning API specific occurs.
 * @throws ServiceException If a generic GData framework error occurs.
 * @throws IOException If an error occurs communicating with the GData
 * service.
 */
public UserFeed retrieveAllUsers()
    throws AppsForYourDomainException, ServiceException, IOException {

  LOGGER.log(Level.INFO,
      "Retrieving all users.");

  URL retrieveUrl = new URL(domainUrlBase + "user/" + SERVICE_VERSION + "/");
  UserFeed allUsers = new UserFeed();
  UserFeed currentPage;
  Link nextLink;

  do {
    currentPage = userService.getFeed(retrieveUrl, UserFeed.class);
    allUsers.getEntries().addAll(currentPage.getEntries());
    nextLink = currentPage.getLink(Link.Rel.NEXT, Link.Type.ATOM);
    if (nextLink != null) {
      retrieveUrl = new URL(nextLink.getHref());
    }
  } while (nextLink != null);

  return allUsers;
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Retrieves all nicknames in domain.  This method may be very slow for
 * domains with a large number of nicknames.  Any changes to nicknames,
 * including creations and deletions, which are made after this method is
 * called may or may not be included in the Feed which is returned.
 *
 * @return A NicknameFeed object of the retrieved nicknames.
 * @throws AppsForYourDomainException If a Provisioning API specific occurs.
 * @throws ServiceException If a generic GData framework error occurs.
 * @throws IOException If an error occurs communicating with the GData
 * service.
 */
public NicknameFeed retrieveAllNicknames()
    throws AppsForYourDomainException, ServiceException, IOException {

  LOGGER.log(Level.INFO,
      "Retrieving all nicknames.");

  URL retrieveUrl = new URL(domainUrlBase + "nickname/"
      + SERVICE_VERSION + "/");
  NicknameFeed allNicknames = new NicknameFeed();
  NicknameFeed currentPage;
  Link nextLink;

  do {
    currentPage = nicknameService.getFeed(retrieveUrl, NicknameFeed.class);
    allNicknames.getEntries().addAll(currentPage.getEntries());
    nextLink = currentPage.getLink(Link.Rel.NEXT, Link.Type.ATOM);
    if (nextLink != null) {
      retrieveUrl = new URL(nextLink.getHref());
    }
  } while (nextLink != null);

  return allNicknames;
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Retrieves all email lists in domain. This method may be very slow for
 * domains with a large number of email lists. Any changes to email lists,
 * including creations and deletions, which are made after this method is
 * called may or may not be included in the Feed which is returned.
 *
 * @return A EmailListFeed object of the retrieved email lists.
 * @throws AppsForYourDomainException If a Provisioning API specific occurs.
 * @throws ServiceException If a generic GData framework error occurs.
 * @throws IOException If an error occurs communicating with the GData
 *         service.
 * @deprecated Email lists have been replaced by Groups. Use
 *             {@link AppsGroupsService#retrieveAllGroups()}
 *             with Groups instead.
 */
@Deprecated
public EmailListFeed retrieveAllEmailLists()
    throws AppsForYourDomainException, ServiceException, IOException {

  LOGGER.log(Level.INFO,
      "Retrieving all email lists.");

  URL retrieveUrl = new URL(domainUrlBase + "emailList/"
      + SERVICE_VERSION + "/");
  EmailListFeed allEmailLists = new EmailListFeed();
  EmailListFeed currentPage;
  Link nextLink;

  do {
    currentPage = emailListService.getFeed(retrieveUrl, EmailListFeed.class);
    allEmailLists.getEntries().addAll(currentPage.getEntries());
    nextLink = currentPage.getLink(Link.Rel.NEXT, Link.Type.ATOM);
    if (nextLink != null) {
      retrieveUrl = new URL(nextLink.getHref());
    }
  } while (nextLink != null);

  return allEmailLists;
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Retrieves all recipients in an email list. This method may be very slow for
 * email lists with a large number of recipients. Any changes to the email
 * list contents, including adding or deleting recipients which are made after
 * this method is called may or may not be included in the Feed which is
 * returned.
 * 
 * @return An EmailListRecipientFeed object of the retrieved recipients.
 * @throws AppsForYourDomainException If a Provisioning API specific occurs.
 * @throws ServiceException If a generic GData framework error occurs.
 * @throws IOException If an error occurs communicating with the GData
 *         service.
 * @deprecated Email lists have been replaced by Groups. Use
 *             {@link AppsGroupsService#retrieveAllMembers(String)}
 *             with Groups instead.
 */
@Deprecated
public EmailListRecipientFeed retrieveAllRecipients(String emailList)
    throws AppsForYourDomainException, ServiceException, IOException {

  LOGGER.log(Level.INFO,
      "Retrieving all recipients in emailList '" + emailList + "'.");

  URL retrieveUrl = new URL(domainUrlBase + "emailList/"
      + SERVICE_VERSION + "/" + emailList + "/recipient/");

  EmailListRecipientFeed allRecipients = new EmailListRecipientFeed();
  EmailListRecipientFeed currentPage;
  Link nextLink;

  do {
    currentPage = emailListRecipientService.getFeed(retrieveUrl, EmailListRecipientFeed.class);
    allRecipients.getEntries().addAll(currentPage.getEntries());
    nextLink = currentPage.getLink(Link.Rel.NEXT, Link.Type.ATOM);
    if (nextLink != null) {
      retrieveUrl = new URL(nextLink.getHref());
    }
  } while (nextLink != null);

  return allRecipients;
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Retrieves the comments for the given photo.
 */
public List<CommentEntry> getComments(PhotoEntry photo) throws IOException,
        ServiceException {

    String feedHref = getLinkByRel(photo.getLinks(), Link.Rel.FEED);
    AlbumFeed albumFeed = getFeed(feedHref, AlbumFeed.class);

    List<GphotoEntry> entries = albumFeed.getEntries();
    List<CommentEntry> comments = new ArrayList<CommentEntry>();
    for (GphotoEntry entry : entries) {
        GphotoEntry adapted = entry.getAdaptedEntry();
        if (adapted instanceof CommentEntry) {
            comments.add((CommentEntry) adapted);
        }
    }
    return comments;
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Retrieves the comments for the given photo.
 */
public List<CommentEntry> getComments(PhotoEntry photo) throws IOException,
    ServiceException {

  String feedHref = getLinkByRel(photo.getLinks(), Link.Rel.FEED);
  AlbumFeed albumFeed = getFeed(feedHref, AlbumFeed.class);

  List<GphotoEntry> entries = albumFeed.getEntries();
  List<CommentEntry> comments = new ArrayList<CommentEntry>();
  for (GphotoEntry entry : entries) {
    GphotoEntry adapted = entry.getAdaptedEntry();
    if (adapted instanceof CommentEntry) {
      comments.add((CommentEntry) adapted);
    }
  }
  return comments;
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Retrieves the tags for the given taggable entry.  This is valid on user,
 * album, and photo entries only.
 */
public List<TagEntry> getTags(GphotoEntry<?> parent) throws IOException,
    ServiceException {

  String feedHref = getLinkByRel(parent.getLinks(), Link.Rel.FEED);
  feedHref = addKindParameter(feedHref, "tag");
  AlbumFeed albumFeed = getFeed(feedHref, AlbumFeed.class);

  List<GphotoEntry> entries = albumFeed.getEntries();
  List<TagEntry> tags = new ArrayList<TagEntry>();
  for (GphotoEntry entry : entries) {
    GphotoEntry adapted = entry.getAdaptedEntry();
    if (adapted instanceof TagEntry) {
      tags.add((TagEntry) adapted);
    }
  }
  return tags;
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Prints detailed information regarding a Generic Entry
 *
 * @param entry The entry of interest
 **/
private static void printBasicEntryDetails(BaseEntry entry){
  System.out.println("\tTitle: " + entry.getTitle().getPlainText());
  System.out.println("\tAtom ID: " + entry.getId());
  System.out.println("\tLast updated: " + entry.getUpdated());
  System.out.println("\tEntry Categories:");
  Iterator it = entry.getCategories().iterator();
  while (it.hasNext()) {
    System.out.println("\t\t" + it.next().toString());
  }
  System.out.println("\tLinks:");
  if (entry.getLinks().size() == 0) {
    System.out.println("\t\t<No links, sorry!>");
  }
  for (int i = 0; i < entry.getLinks().size(); i++) {
    System.out.println("\t\t" + ((Link) (entry.getLinks().get(i))).getHref());
  }
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Creates a web attachment under the selected file cabinet.
 *
 * @param contentUrl The full URL of the hosted file.
 * @param filecabinet File cabinet to create the web attachment on.
 * @param title A title for the attachment.
 * @param description A description for the attachment.
 * @return The created web attachment.
 * @throws ServiceException
 * @throws IOException
 * @throws MalformedURLException
 */
public WebAttachmentEntry uploadWebAttachment(String contentUrl,
    FileCabinetPageEntry filecabinet, String title, String description)
    throws MalformedURLException, IOException, ServiceException {
  MediaContent content = new MediaContent();
  content.setUri(contentUrl);

  WebAttachmentEntry webAttachment = new WebAttachmentEntry();
  webAttachment.setTitle(new PlainTextConstruct(title));
  webAttachment.setSummary(new PlainTextConstruct(description));
  webAttachment.setContent(content);
  webAttachment.addLink(SitesLink.Rel.PARENT, Link.Type.ATOM,
      filecabinet.getSelfLink().getHref());

  return service.insert(new URL(getContentFeedUrl()), webAttachment);
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Set the web content for this entry
 */
public void setWebContent(WebContent wc) {
  Link oldWebContentLink = getWebContentLink();
  if (wc == null) {
    // option 1: remove old Link
    if (oldWebContentLink != null) {
      getLinks().remove(oldWebContentLink);
    }
  } else if (oldWebContentLink == null) {
    // option 2: add new Link
    getLinks().add(wc.getLink());
  } else if (oldWebContentLink != wc.getLink()) {
    // option 3: replace old Link
    getLinks().remove(oldWebContentLink);
    getLinks().add(wc.getLink());
  }
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Retrieves the tags for the given taggable entry.  This is valid on user,
 * album, and photo entries only.
 */
public List<TagEntry> getTags(GphotoEntry<?> parent) throws IOException,
        ServiceException {

    String feedHref = getLinkByRel(parent.getLinks(), Link.Rel.FEED);
    feedHref = addKindParameter(feedHref, "tag");
    AlbumFeed albumFeed = getFeed(feedHref, AlbumFeed.class);

    List<GphotoEntry> entries = albumFeed.getEntries();
    List<TagEntry> tags = new ArrayList<TagEntry>();
    for (GphotoEntry entry : entries) {
        GphotoEntry adapted = entry.getAdaptedEntry();
        if (adapted instanceof TagEntry) {
            tags.add((TagEntry) adapted);
        }
    }
    return tags;
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Print the contents of a ContactEntry to System.err.
 *
 * @param contact The ContactEntry to display.
 */
private static void printContact(ContactEntry contact) {
  System.err.println("Id: " + contact.getId()); 
  if (contact.getTitle() != null) {
    System.err.println("Contact name: " + contact.getTitle().getPlainText());
  } else {
    System.err.println("Contact has no name");
    
  }
  System.err.println("Last updated: " + contact.getUpdated().toUiString());
  if (contact.hasDeleted()) {
    System.err.println("Deleted:");
  }

  ElementHelper.printContact(System.err, contact);
  
  Link photoLink = contact.getLink(
      "http://schemas.google.com/contacts/2008/rel#photo", "image/*");
  System.err.println("Photo link: " + photoLink.getHref());
  String photoEtag = photoLink.getEtag();
  System.err.println("  Photo ETag: "
      + (photoEtag != null ? photoEtag : "(No contact photo uploaded)"));
  System.err.println("Self link: " + contact.getSelfLink().getHref());
  System.err.println("Edit link: " + contact.getEditLink().getHref());
  System.err.println("ETag: " + contact.getEtag());
  System.err.println("-------------------------------------------\n");
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Prints out the specified document entry.
 *
 * @param doc the document entry to print.
 */
public void printDocumentEntry(DocumentListEntry doc) {
  StringBuffer output = new StringBuffer();

  output.append(" -- " + doc.getTitle().getPlainText() + " ");
  if (!doc.getParentLinks().isEmpty()) {
    for (Link link : doc.getParentLinks()) {
      output.append("[" + link.getTitle() + "] ");
    }
  }
  output.append(doc.getResourceId());

  out.println(output);
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Prints out the specified document entry.
 *
 * @param doc the document entry to print.
 */
public void printDocumentEntry(DocumentListEntry doc) {
  StringBuffer outputBuffer = new StringBuffer();

  outputBuffer.append(" -- " + doc.getTitle().getPlainText() + " ");
  if (!doc.getParentLinks().isEmpty()) {
    for (Link link : doc.getParentLinks()) {
      outputBuffer.append("[" + link.getTitle() + "] ");
    }
  }
  outputBuffer.append(doc.getResourceId());

  output.println(outputBuffer);
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Insert an entry into another entry.  Because our entries are a hierarchy,
 * this lets you insert a photo into an album even if you only have the
 * album entry and not the album feed, making it quicker to traverse the
 * hierarchy.
 */
public <T extends GphotoEntry> T insert(GphotoEntry<?> parent, T entry)
        throws IOException, ServiceException {

    String feedUrl = getLinkByRel(parent.getLinks(), Link.Rel.FEED);

    return service.insert(new URL(feedUrl), entry);
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Retrieves the calendar metafeed to get the ACL feed URLs for each calendar.
 * Then prints the access control lists for each of the user's calendars.
 * 
 * @param service An authenticated CalendarService object.
 * @throws ServiceException If the service is unable to handle the request.
 * @throws IOException Error communicating with the server.
 */
private static void printAclList(CalendarService service)
    throws ServiceException, IOException {
  CalendarFeed calendarFeed = service
      .getFeed(metafeedUrl, CalendarFeed.class);

  // After accessing the meta-feed, get the ACL link for each calendar.
  System.out.println("Access control lists for your calendars:");
  for (CalendarEntry calEntry : calendarFeed.getEntries()) {
    Link link = calEntry.getLink(AclNamespace.LINK_REL_ACCESS_CONTROL_LIST,
        Link.Type.ATOM);

    // For each calendar that exposes an access control list, retrieve its ACL
    // feed. If link is null, then we are not the owner of that calendar
    // (e.g., it is a public calendar) and its ACL feed cannot be accessed.
    if (link != null) {
      AclFeed aclFeed = service.getFeed(new URL(link.getHref()),
          AclFeed.class);
      System.out.println("\tCalendar \"" + calEntry.getTitle().getPlainText()
          + "\":");
      for (AclEntry aclEntry : aclFeed.getEntries()) {
        System.out.println("\t\tScope: Type=" + aclEntry.getScope().getType()
            + " (" + aclEntry.getScope().getValue() + ")");
        System.out.println("\t\tRole: " + aclEntry.getRole().getValue());
      }
    }
  }
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
@Override
public void declareExtensions(ExtensionProfile extProfile) {
  if (extProfile.isDeclared(TmsElement.class)) {
    return;
  }
  extProfile.declare(TmsElement.class, new ExtensionDescription(Link.class,
      new XmlNamespace("atom", "http://www.w3.org/2005/Atom"), "link", true,
      true, false));
}
 

import com.google.gdata.data.Link; //导入依赖的package包/类
/**
 * Insert an entry into another entry.  Because our entries are a hierarchy,
 * this lets you insert a photo into an album even if you only have the
 * album entry and not the album feed, making it quicker to traverse the
 * hierarchy.
 */
public <T extends GphotoEntry> T insert(GphotoEntry<?> parent, T entry)
    throws IOException, ServiceException {

  String feedUrl = getLinkByRel(parent.getLinks(), Link.Rel.FEED);
  return service.insert(new URL(feedUrl), entry);
}