Google Verileri Java İstemci Kitaplığı'nı Kullanmaya Başlama

stephanie Liu, Google Veri API'leri Ekibi
Eylül 2007

1. Giriş
2. Bağımlılıkları Yükleme
   1. Windows'da
   2. Mac OS X'te
   3. Linux'ta
3. Google Veri İstemcisi Kitaplığı'nı yükleme
4. Koşu Örnekleri
5. Kendi uygulamalarınızı oluşturma
6. Sonuç
7. Ek: Ortam Değişkenlerini Ayarlama

Giriş

Bilmediğiniz bir API ile geliştirme yapmaya başlamak hiç kolay olmadığı için bu makalede Google Veri API'ları ("GData") Java İstemci Kitaplığı'nı nasıl indirip yükleyeceğinizle ilgili adım adım talimatlar verilmiştir. Tüm bağımlıları ele alacağız ve ihtiyacınız olan ortam değişkenlerini ayarlayacağım. Farklı GData hizmetlerini çok kısa sürede birleştireceksiniz!

Eclipse mi kullanıyorsunuz?

Coding in the Shade: Use Eclipse with Google Data API'ler (Kodda Kodlama: Eclipse'i Google Veri API'leriyle Kullanma) makalesine göz atın.

Bağımlıları Yükleme

GData Java İstemci Kitaplığı'nda aşağıdaki harici bağımlılıklar bulunur. Aşağıdaki bölümlerde, bu bağımlılıkları favori işletim sisteminize (veya iş yerinde kaldığınız işletim sistemine) nasıl yükleyeceğiniz açıklanmaktadır.

• JDK (Java Geliştirme Kiti) 1.5 ve üzeri sürümler
• Apache Ant 1.7 ve sonraki sürümleri
• Sun'ın JavaMail API 1.4 ve sonraki sürümlerinde mail.jar
• Sun. JavaBeansActivateFramework'te etkinleştirme.jar. Bu özellik yalnızca Document List Data API, Picasa Web Album API'si ve YouTube Data API'sı dahil olmak üzere, medyaya özel API'lar için gereklidir.
• servlet.jar, Sun'ın Servlet API'sinin 2.3 ve sonraki sürümleri. Bu işlem yalnızca "sample.authsub" veya "sample.gbase.Recipe" paketlerinde kod örnekleri yürütülürken gereklidir.

.jar bağımlılıklarından birkaçı yalnızca belirli örnekler için gereklidir ancak derleme hatalarını önlemek için en iyisi her şeyi almaktır. Devam etmek için işletim sisteminizi seçin: Windows, Mac OS X veya Linux.

Windows'da

Windows işletim sistemi için talimatlar.

Java'yı yükleme

Java geliştirme paketi Sun'dan JDK (Java Geliştirme Kiti) biçiminde sunulur. JRE (Java Çalışma Zamanı Ortamı) ve Java uygulamaları yazmak, derlemek, test etmek ve hata ayıklamak için ihtiyacınız olan her şey burada bulunur. Java'yı zaten yüklediyseniz Ant'i yükleme adımına geçin.

Not: JDK'yi yüklemek için yönetici izinlerinizin olması gerekir.

1. http://java.sun.com/javase/downloads/index.jsp adresini ziyaret edin.
2. Son güncellemenin yanındaki "İndir"i tıklayın.
3. Lisans Sözleşmesi'ni okuyun ve kabul edin.
4. Windows yükleme dosyalarından birini indirin.
5. Yükleyiciyi çalıştırın.
6. javac gibi JDK yürütülebilir dosyalarını kolayca çalıştırmak için Path ortam değişkenini düzenleyin. Eklemek istediğiniz yol C:\jdk\bin\ görünümüne benzeyecek. Windows'da Path değişkenini düzenlemeyle ilgili talimatlar için Ek'i inceleyin.

JDK'yi yükleme konusunda sorun yaşarsanız Sun'ın web sitesindeki ayrıntılı yükleme talimatlarına göz atın.

Karınca Yükleniyor

Apache Ant, make'a benzer (ancak daha iyi) Java için bir derleme aracıdır. Kitaplığı oluşturmak ve örnekleri yürütmek için bu kitaplığı kullanacaksınız. Ant zaten yüklüyse 1.7 veya daha yeni bir sürümün yüklü olup olmadığını kontrol edin.

1. "Başlat" menüsünü, ardından "Çalıştır"ı tıklayın.
2. Metin alanına cmd yazın.
3. Hangi sürüme sahip olduğunuzu görmek için isteme ant -version yazın.

1.7 veya sonraki bir sürüme sahipseniz mail.jar edinme adımına geçin. Ant sürümünüz 1.7'den eskiyse veya cihazınızda yüklü değilse aşağıdaki adımları uygulayın.

1. http://ant.apache.org/bindownload.cgi adresini ziyaret edin.
2. .zip indirmesi için indirme bağlantısını tıklayın.
3. Tüm dosyaları istediğiniz konuma (C:\ant gibi) çıkarın
4. Path ortam değişkeninize C:\ant\bin gibi karınca bin dizinini ekleyin.
5. Yeni konum olarak ayarlamak için ANT_HOME ortam değişkenini ekleyin veya düzenleyin (ör. C:\ant)
6. Java'nın yüklendiği yere JAVA_HOME ortam değişkenini ekleyin veya düzenleyin (ör. C:\jdk).

Herhangi bir sorunla karşılaşırsanız Ant'in web sitesinde ayrıntılı yükleme talimatlarını bulabilirsiniz.

mail.jar dosyası alınıyor

JavaMail API medya desteği için dahildir.

1. http://java.sun.com/products/javamail/downloads/index.html adresini ziyaret edin.
2. "İndir" düğmesini tıklayın. 1.4 veya daha yeni bir sürümü indirdiğinizden emin olun.
3. Lisans Sözleşmesi'ni okuyun ve kabul edin.
4. JavaMail'i içeren .zip dosyasının bağlantısını tıklayın.
5. Dosyaları bilgisayarınıza çıkarın ve konumu not edin. mail.jar, javamail-(version) kök dizininin altında olacaktır

engagement.jar dosyası alınıyor

JavaBeans Etkinleştirme Çerçevesi medya desteği için dahil edilmiştir.

1. JAF indirme sayfasını ziyaret edin.
2. "İndir" düğmesini tıklayın.
3. Lisans Sözleşmesi'ni okuyun ve kabul edin.
4. Etkinleştirme Çerçevesi'ni içeren .zip dosyasının bağlantısını tıklayın.
5. Dosyaları bilgisayarınıza çıkarın ve konumu not edin. activation.jar, jaf-(version) kök dizininin altında olacaktır

servlet.jar dosyası alınıyor

servlet.jar (servlet-api.jar şeklinde adlandırılabilir), servlet kapsayıcınızda (J2EE, Tomcat, WebLogic vb.) bulunabilir. AuthSub ve Google Base örnekleri için kullanılır. Aşağıdaki talimatlar Tomcat 6.x'i edinmek için geçerlidir.

1. http://tomcat.apache.org/download-60.CGI adresini ziyaret edin.
2. Temel İkili Dağıtımlar altında Windows Service Yükleyici'yi tıklayın.
3. Yükleyiciyi çalıştırın.
4. Varsayılan ayarı değiştirmezseniz servlet-api.jar, C:\Program Files\Apache Software Foundation\Tomcat 6.0\lib adresinde bulunmalıdır

Tomcat'in kurulumu ve yüklenmesiyle ilgili daha fazla dokümanı burada bulabilirsiniz.

Tamam, artık GData Java İstemci Kitaplığı'nı yüklemeye hazırsınız.

Mac OS X'te

Mac OS X işletim sistemine yönelik talimatlar.

Java'yı yükleme

Mac OS X kullanıyorsanız, daha az çalışmanız gerekir. Apple, her örnek için tamamen yapılandırılmış ve kullanıma hazır bir JDK (Java Geliştirme Kiti) içerir. Daha fazla bilgi için Apple'ın Java sitesini inceleyin.

Karınca Yükleniyor

Apache Ant, make'a benzer (ancak daha iyi) Java için bir derleme aracıdır. Kitaplığı oluşturmak ve örnekleri yürütmek için bu kitaplığı kullanacaksınız. Ant'i zaten yüklemiş olabilirsiniz ancak 1.7 veya üzeri bir sürüme sahip olduğunuzdan emin olun.

1. Bir terminal penceresi açın. (Komut + Boşluk çubuğuna basıp uygulamayı bulmak için "Terminal" yazın)
2. Komut isteminde şunu yazın:

ant -version

Çalıştırdığınız karınca sürümü 1.7'den eskiyse en son sürümü edinmek için aşağıdaki adımları uygulayın.

1. http://ant.apache.org/bindownload.cgi adresini ziyaret edin.
2. .zip indirmesi için indirme bağlantısını tıklayın.
3. Bir terminal penceresi açın. (Komut + Boşluk çubuğuna basıp uygulamayı bulmak için "Terminal" yazın)
4. Komut isteminde aşağıdakileri yazın:
   • cd ~/Desktop
   • sudo sh
   • mv apache-ant-(version)-bin.zip /usr/local/
   • cd /usr/local/
   • unzip apache-ant-(version)-bin.zip
   • chown (your account name):(your account name) apache-ant-(version)
   • ln -s apache-ant-(version) ant

Herhangi bir sorunla karşılaşırsanız Ant'in web sitesinde ayrıntılı yükleme talimatlarını bulabilirsiniz. Bu blog yayınında da yukarıdaki kabuk komutlarının ne anlama geldiği hakkında ayrıntılı bir açıklama vardır.

mail.jar dosyası alınıyor

JavaMail API medya desteği için dahildir.

1. http://java.sun.com/products/javamail/downloads/index.html adresini ziyaret edin.
2. "İndir" düğmesini tıklayın. 1.4 veya daha yeni bir sürümü indirdiğinizden emin olun.
3. Lisans Sözleşmesi'ni okuyun ve kabul edin.
4. JavaMail'i içeren .zip dosyasının bağlantısını tıklayın.
5. Dosyaları bilgisayarınıza çıkarın ve konumu not edin. mail.jar, javamail-(version) kök dizininin altında olacaktır

engagement.jar dosyası alınıyor

JavaBeans Etkinleştirme Çerçevesi medya desteği için dahil edilmiştir.

1. JAF indirme sayfasını ziyaret edin.
2. "İndir" düğmesini tıklayın.
3. Lisans Sözleşmesi'ni okuyun ve kabul edin.
4. Etkinleştirme Çerçevesi'ni içeren .zip dosyasının bağlantısını tıklayın.
5. Dosyaları bilgisayarınıza çıkarın ve konumu not edin. activation.jar, jaf-(version) kök dizininin altında olacaktır

servlet.jar dosyası alınıyor

servlet.jar (servlet-api.jar şeklinde adlandırılabilir), servlet kapsayıcınızda (J2EE, Tomcat, WebLogic vb.) bulunabilir. AuthSub ve Google Base örnekleri için kullanılır. Aşağıdaki talimatlar Tomcat 6.x'i edinmek için geçerlidir.

1. http://tomcat.apache.org/download-60.CGI adresini ziyaret edin.
2. Temel İkili Dağıtımlar altında .zip indirmesini tıklayın.
3. Dosyaları bilgisayarınıza çıkarın ve konumu not edin. servlet.jar, apache-tomcat-(version)/lib altında bulunur

Tomcat'in kurulumu ve yüklenmesiyle ilgili daha fazla dokümanı burada bulabilirsiniz.

Tamam, artık GData Java İstemci Kitaplığı'nı yüklemeye hazırsınız.

Linux'ta

Linux işletim sistemine yönelik talimatlar.

Java'yı yükleme

Bu eğitimde Sun'un JDK (Java Geliştirme Kiti) kullanılır. Kök erişiminiz varsa lütfen aşağıdaki talimatları uygulayın. Aksi takdirde, bu talimatları uygulayarak JDK'yi ana dizininize yüklemeniz yeterlidir. JDK 1.5+ zaten yüklüyse Ant Ant Yükleme'ye geçin.

Kök ayrıcalıklarınız varsa:

1. http://java.sun.com/javase/downloads/index.jsp adresini ziyaret edin.
2. Son sürümün yanındaki "İndir" seçeneğini tıklayın.
3. Lisans Sözleşmesi'ni okuyun ve kabul edin.
4. "Linux Platformu" bölümünde BGBG dosyasının kendi kendini ayıklayan dosyasını tıklayın ve indirin.
5. Bir terminal penceresi açın, dosyayı indirdiğiniz dizine geçin ve aşağıdakileri yapın:
• su
• chmod a+x jdk-6(version)-linux-i586-rpm.bin
• ./jdk-6(version)-linux-i586-rpm.bin
• Lisans sözleşmesini kabul edin.

Kök ayrıcalıklarınız yoksa:

1. http://java.sun.com/javase/downloads/index.jsp adresini ziyaret edin.
2. Son sürümün yanındaki "İndir" seçeneğini tıklayın.
3. Lisans Sözleşmesi'ni okuyun ve kabul edin.
4. "Linux Platform" altında kendi kendini çıkaran derlemeyi (BGBG değil) tıklayın ve indirin.
5. Bir terminal penceresi açın, dosyayı indirdiğiniz dizine geçin ve aşağıdaki komutları yazın:
• chmod +x jdk-6(version)-linux-i586-rpm.bin
• Dosyayı yüklemek istediğiniz dizine değiştirin.
• Kendi kendini çıkaran ikili programı çalıştırın. Geçerli dizine yüklüyorsanız ./jdk-6(version)-linux-i586-rpm.bin yazmanız yeterlidir.
• Lisans sözleşmesini kabul edin.

Sorun yaşarsanız daha ayrıntılı yükleme talimatlarını burada bulabilirsiniz.

Karınca Yükleniyor

GData Java İstemci Kitaplığı'nın 1.7 veya daha yeni bir sürüme sahip olması gerekir. Ant zaten yüklüyse komut istemine ant -version yazarak sürümü kontrol edin. En son sürümü edinmeniz gerekiyorsa veya uygulamayı yüklemediyseniz aşağıdaki talimatları uygulayın. Java ve Ant yüklemeleriniz önceden yapılmışsa mail.jar uygulamasını edinme adımına atlayın.

1. http://ant.apache.org/bindownload.cgi adresini ziyaret edin.
2. .tar.gz indirmesi için indirme bağlantısını tıklayın.
3. Bir terminal penceresi açıp indirilen dosyayı dizine ekleyerek ve aşağıdaki komutları yazarak dosyaları çıkarın:
• gunzip apache-ant-(version)-bin.tar.gz
• tar xvf apache-ant-(version)-bin.tar
4. Karınca bin dizinini PATH ortam değişkeninize ekleyin.
5. Yeni konum olarak ayarlamak için ANT_HOME ortam değişkenini ekleyin veya düzenleyin.
6. JDK'nin yüklü olduğu konum olarak ayarlamak için JAVA_HOME ortam değişkenini ekleyin veya düzenleyin.

Herhangi bir sorunla karşılaşırsanız Ant yükleme belgelerine buradan ulaşabilirsiniz.

mail.jar dosyası alınıyor

JavaMail API medya desteği için dahildir.

1. http://java.sun.com/products/javamail/downloads/index.html adresini ziyaret edin.
2. "İndir" düğmesini tıklayın. 1.4 veya daha yeni bir sürümü indirdiğinizden emin olun.
3. Lisans Sözleşmesi'ni okuyun ve kabul edin.
4. JavaMail'i içeren .zip dosyasının bağlantısını tıklayın.
5. Dosyaları bilgisayarınıza unzip ekleyin ve konumu not edin. mail.jar, javamail-(version) kök dizininin altında olacaktır

engagement.jar dosyası alınıyor

JavaBeans Etkinleştirme Çerçevesi medya desteği için dahil edilmiştir.

1. JAF indirme sayfasını ziyaret edin.
2. "İndir" düğmesini tıklayın.
3. Lisans Sözleşmesi'ni okuyun ve kabul edin.
4. Etkinleştirme Çerçevesi'ni içeren .zip dosyasının bağlantısını tıklayın.
5. Dosyaları bilgisayarınıza unzip ekleyin ve konumu not edin. activation.jar, jaf-(version) kök dizininin altında olacaktır

servlet.jar dosyası alınıyor

servlet.jar (servlet-api.jar şeklinde adlandırılabilir), servlet kapsayıcınızda (J2EE, Tomcat, WebLogic vb.) bulunabilir. AuthSub ve Google Base örnekleri için kullanılır. Aşağıdaki talimatlar Tomcat 6.x'i edinmek için geçerlidir.

1. http://tomcat.apache.org/download-60.CGI adresini ziyaret edin.
2. Temel İkili Dağıtımlar altındaki .tar.gz dosyasını indirin.
3. İndirme işlemini yukarıdaki Karıncayı Yükleme bölümünde gösterildiği gibi gunzip ve tar ile birlikte sunun.
4. servlet.jar, apache-tomcat-(version)/lib altında bulunur

Artık GData Java İstemci Kitaplığı'nı almak için ihtiyacınız olan her şeye sahipsiniz.

Google Veri İstemcisi Kitaplığı'nı yükleme

1. http://code.google.com/p/gdata-java-client/downloads/list adresini ziyaret edin.
2. İstemci kitaplığının (gdata-src.java-1.x.x.java.zip) en güncel sürümünü ve örnekleri (gdata-samples.java-1.x.x.java.zip) indirin.
3. İstemci kitaplığı kaynağını bilgisayarınıza çıkarın.
4. gdata/java/build-src/build.properties adresine gidin ve dosyayı açın.
5. Harici bağımlılıkları, yerel makinenizdeki .jar dosyalarının konumlarını işaret edecek şekilde düzenleyin.

Not: Windows'da ters eğik çizgilerden kaçınmayı unutmayın. Örneğin,

servlet.jar=C:\\Program Files\\Apache Software Foundation\\Tomcat 6.0\\lib\\servlet-api.jar

Örnekleri Çalıştırma

Kullanılabilen tüm örnekler gdata-samples.java-1.x.x.java.zip arşivinde gdata/java/sample altında bulunmaktadır. gdata/java/build-samples/build.properties dosyası, kitaplıkta bulunan örneklerin tüm giriş değerlerini içerir. sample.credentials.username ve sample.credentials.password değerlerini geçerli bir kullanıcı adı ve şifre olarak belirleyin. Ant'i kullanarak örnekleri oluşturabiliyor ve yürütebiliyoruz.

Bir komut istemi açıp gdata/java dizinine geçerek ve şunları yazarak her şeyi doğru bir şekilde yükleyip yüklemediğinizi kontrol edin:

ant -f build-samples.xml sample.calendar.run

Bazı bilgiler veya uyarı mesajları alabilirsiniz ancak sonda BUILD SUCCESSFUL mesajına bakın. Başarılı bir mesaj görmezseniz sorun giderme bölümüne bakın.

Şunları yazarak daha etkileşimli bir örnek deneyin:

ant -f build-samples.xml sample.spreadsheet.guidemo.run

Belirli bir örneği nasıl çalıştıracağınızı öğrenmek için gdata/java/build-samples sayfasına gidip ilgili örneğin derleme dosyasını kontrol edin. samples run bölümünü bulun.

Sorun giderme

Derlemeniz aşağıdaki gibi bir hata mesajıyla başarısız olursa:

BUILD FAILED
Target 'core.sample.core.util.build' does not exist in this project. It is used from target 'sample.calendar.build'.

Total time: 0 seconds

veya projede yer almayan önemli bir dosyayla ilgili benzer bir hata mesajıyla Ant'in eski bir sürümünü çalıştırıyor olabilirsiniz. 1.7 veya sonraki bir sürümü çalıştırdığınızdan emin olmak için ant -version yazın. Ant'in en son sürümünü edinmek için yukarıdaki bağımlılık talimatlarına bakın.

Kendi Uygulamalarınızı Oluşturma

Sıradaki soru, kendi uygulamanızı nasıl oluşturabileceğinizdir. Temel işlevleri göstermek için Takvim hizmetini kullanan "Hello, World!" eşdeğer programını gerçekleştireceğim. Daha ayrıntılı bilgileri, Java İstemci Kitaplığı'nın geliştirici kılavuzunda ve ürün geliştirici kılavuzlarında bulabilirsiniz.

CalendarTest.java adlı bir dosya oluşturun. Aşağıdaki içe aktarma ifadelerini ekleyerek başlayın.

import com.google.gdata.client.*;
import com.google.gdata.client.calendar.*;
import com.google.gdata.data.*;
import com.google.gdata.data.acl.*;
import com.google.gdata.data.calendar.*;
import com.google.gdata.data.extensions.*;
import com.google.gdata.util.*;

import java.net.*;
import java.io.*;

import sample.util.*;

Tüm programı (istisnalarla ilgili işlem yapmadan) burada bulabilirsiniz.

public class CalendarTest {

    public static void main(String[] args) {
        CalendarService myService = new CalendarService("exampleCo-exampleApp-1.0");
        myService.setUserCredentials("[e-mail]", "pa$$word");

        URL feedUrl = new URL("http://www.google.com/calendar/feeds/default/allcalendars/full");
        CalendarFeed resultFeed = myService.getFeed(feedUrl, CalendarFeed.class);

        System.out.println("Your calendars:");
        System.out.println();

        for (int i = 0; i < resultFeed.getEntries().size(); i++) {
          CalendarEntry entry = resultFeed.getEntries().get(i);
          System.out.println("\t" + entry.getTitle().getPlainText());
        }

    }
}

This little program will request all the calendars you own and display all the titles. It's a little longer than the canonical "Hello, World!" example, but it's very simple once we break it down. The first couple of lines creates a service object and sets the user credentials.

CalendarService myService = new CalendarService("exampleCo-exampleApp-1.0");
myService.setUserCredentials("[e-mail]", "pa$$word");

Ardından, kaynağın URL'si ayarlanır. Bu durumda, kimliği doğrulanmış kullanıcıdan tüm takvimlerin listesini talep edebileceğiniz yer burasıdır.

URL feedUrl = new URL("http://www.google.com/calendar/feeds/default/allcalendars/full");

Aşağıdaki satır, URL'de gerçek GET komutunu çalıştıracak ve elde edilen feed'i düzenli bir nesneye dönüştürecektir.

CalendarFeed resultFeed = myService.getFeed(feedUrl, CalendarFeed.class);

Aşağıdaki for döngüsü, her girişi tekrarlar ve başlığı yazdırır. Başlığın TextConstruct olarak depolandığını ve dolayısıyla düz metni almak için fazladan bir işlev çağrısının gerekli olduğunu unutmayın.

for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    CalendarEntry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" + entry.getTitle().getPlainText());
}

Bu çözüm oldukça basitti. Şimdi, sık kullanılan birkaç noktaya göz atalım. Aşağıdaki snippet'te, bir nesnenin nasıl oluşturulacağı ve yerleştirileceği gösterilmektedir. Örneğin, bu yeni bir takvim etkinliği girişidir.

URL postURL = new URL("http://www.google.com/calendar/feeds/[e-mail]/private/full");
CalendarEventEntry myEvent = new CalendarEventEntry();

//Set the title and description
myEvent.setTitle(new PlainTextConstruct("Pi Day Party"));
myEvent.setContent(new PlainTextConstruct("I am throwing a Pi Day Party!"));

//Create DateTime events and create a When object to hold them, then add
//the When event to the event
DateTime startTime = DateTime.parseDateTime("2007-03-14T15:00:00-08:00");
DateTime endTime = DateTime.parseDateTime("2007-03-14T17:00:00-08:00");
When eventTimes = new When();
eventTimes.setStartTime(startTime);
eventTimes.setEndTime(endTime);
myEvent.addTime(eventTimes);

// POST the request and receive the response:
CalendarEventEntry insertedEntry = myService.insert(postURL, myEvent);

Sık kullanılan diğer bir işlem de sorgu oluşturmaktır.

//Create a new query object and set the parameters
Query myQuery = new Query(feedURL);
myQuery.setFullTextQuery("Pi");

//Send the request with the built query URL
CalendarEventFeed myResultsFeed = myService.query(myQuery, CalendarEventFeed.class);

//Take the first match and print the title
if (myResultsFeed.getEntries().size() > 0) {
    CalendarEventEntry firstMatchEntry = new CalendarEventEntry();
    myResultsFeed.getEntries().get(0);
    System.out.println(firstMatchEntry.getTitle().getPlainText());
}

Hata ayıklama sırasında diğer yararlı bir işlem de ham XML'yi göndermektir. Kitaplıkta bunu yapmak için kullanabileceğin pratik bir yardımcı program var. samples.util.* uygulamasının içe aktarıldığından emin olun. Ardından, feed'i veya girişi doldurun.

CommonUtils.dump(resultFeed, System.out);

Daha da fazla hata ayıklama aracı için istemci kitaplığı içinden günlük kaydını etkinleştirmeyle ilgili Google Data API İstemcilerinde Hata Ayıklama: Programınız İçinde Trafiği Keşfetme makalemize bakın.

Bu, istemci kitaplığını kullanarak uygulama oluşturma sürecinin nasıl olduğu hakkında size bir fikir verecektir. Daha ayrıntılı bilgi için Google Cloud API'deki kullanılabilir geliştirici kılavuzlarının listesine göz atın.

Sonuç

Artık GData Java İstemci Kitaplığı'nı kullanarak uygulama oluşturup çalıştırabildiğinizi umuyoruz. Kullanabileceğiniz popüler IDE'lerden herhangi birine girmedim ancak Eclipse veya NetBeans gibi popüler araçlara göz atabilirsiniz. Size yardımcı olabilecek bazı ek bağlantılar şunlardır:

• GData Java İstemci Kitaplığı ana sayfası
• Google Veri API'lerinin listesi
• Java Geliştirici Kılavuzu aşağıdaki Google Veri API'lerinde kullanılabilir:
  • Alışveriş için Content API
  • Blogger
  • Kişiler
  • Google Takvim
  • Google Dokümanlar Listesi
  • Google Finans
  • Google E-Tablolar
  • Google Search Console
  • YouTube
• Gölgelendirme: Eclipse'i Google Veri API'leriyle Kullanma
• Google Veri API'ları Java Client Eclipse Eklentisi

Herhangi bir API ile Java İstemci Kitaplığı'nı kullanma hakkında sorularınız varsa API'ye özel forumlarda sorularınızı yayınlayabilirsiniz.

Ek: Ortam Değişkenlerini Ayarlama

Windows veya Linux'ta ortam değişkenlerinizi ayarlama talimatları. Mac OS X için herhangi bir ayar yapmanız gerekmez.

Windows

Sistem değişkenleri, bilgisayardaki tüm kullanıcılar için geçerli olur. Yönetici ayrıcalıklarınız olmadığı için sistem değişkenlerini düzenleyemiyorsanız buradaki talimatları uygulayın.

Yönetici ayrıcalıklarınız varsa:

1. "Bilgisayarım"ı sağ tıklayın ve "Özellikler"i seçin.
2. "Gelişmiş" sekmesini tıklayın.
3. "Ortam Değişkenleri"ni tıklayın.
4. "Ekle" veya "Düzenle" sistem değişkenleri: (konumu yerel makinenizde değiştirin)
• ANT_HOME ekleyin veya düzenleyin ve değeri C:\ant olarak ayarlayın
• JAVA_HOME ekleyin veya düzenleyin ve değeri C:\jdk olarak ayarlayın
• Path ekle veya düzenle ve sonuna ;C:\ant\bin;C:\jdk\bin ekle (noktalı virgül dizin yollarını ayırır)
• CLASSPATH ekleyin veya düzenleyin ve hangi hizmetlerle çalışmak istediğinize bağlı olarak ihtiyaç duyacağınız .jar dosyaları ekleyin. "." karakterinin eklendiğinden emin olun; &mhash geçerli dizini belirtir. .;C:\gdata\java\lib\gdata-core-1.0.jar;C:\gdata\java\lib\gdata-calendar-1.0.jar vb.
5. Geçerli olduklarından emin olmak için yeniden başlatın.

Not: Değişkenlerde tırnak işareti (' veya ") bulunmadığından ve \ ya da / ile bitmediğinden emin olun.

Yönetici ayrıcalıklarınız yoksa:

1. "Bilgisayarım"ı sağ tıklayın ve "Özellikler"i seçin.
2. "Gelişmiş" sekmesini tıklayın.
3. "Ortam Değişkenleri"ni tıklayın.
4. "Ekle" veya "Düzenle" kullanıcı değişkenleri: (yerel makinenizde konumu değiştirin)
• ANT_HOME ekleyin veya düzenleyin ve değeri C:\ant olarak ayarlayın
• JAVA_HOME ekleyin veya düzenleyin ve değeri C:\jdk olarak ayarlayın
• Path ekle veya düzenle ve sonuna ;C:\ant\bin;C:\jdk\bin ekle (noktalı virgül dizin yollarını ayırır)
• CLASSPATH ekleyin veya düzenleyin ve hangi hizmetlerle çalışmak istediğinize bağlı olarak ihtiyaç duyacağınız .jar dosyaları ekleyin. "." karakterinin eklendiğinden emin olun; &mhash geçerli dizini belirtir. .;C:\gdata\java\lib\gdata-core-1.0.jar;C:\gdata\java\lib\gdata-calendar-1.0.jar vb.
5. Geçerli olduklarından emin olmak için yeniden başlatın.

Not: Değişkenlerde tırnak işareti (' veya ") bulunmadığından ve \ ya da / ile bitmediğinden emin olun.

Düzenlediğiniz kullanıcı değişkenleri yalnızca kullanıcı profilinize uygulanır.

Linux

1. .bash_profile dosyanızı tercih ettiğiniz düzenleyicide açın. Bu dizinde ana dizininiz yer alır.
2. Aşağıdakileri .bash_profile dosyanıza ekleyerek makinenizdeki dosyaların gerçek konumlarını değiştirin:
• export ANT_HOME=/usr/local/ant
• export JAVA_HOME=/usr/local/jdk
• export PATH=${PATH}:${ANT_HOME}/bin
• Kullanacağınız hizmetlere ait .jar dosyalarını eklemeniz gerekir. Örneğin, export CLASSPATH=${CLASSPATH}:/home/username/gdata/java/lib/gdata-core-1.0.jar:/home/username/gdata/java/lib/gdata-calendar-1.0.jar:/home/username/gdata/java/sample/util/lib/sample-util.jar
3. Değişkenleri oluşturmak için source .bash_profile

Not: Değişkenlerde tırnak işareti (' veya ") bulunmadığından ve \ ya da / ile bitmediğinden emin olun.