GSP294

Genel bakış

API'ler (uygulama programlama arayüzü), geliştiricilerin bilgi işlem kaynaklarına ve verilere erişmesini sağlayan yazılım programlarıdır. Pek çok farklı sektördeki şirket, geliştiricilerin özel araçları, hizmetleri veya kitaplıkları kendi uygulamaları ve kod tabanıyla entegre edebilmesi için herkese açık API'ler sunar.

Bu laboratuvarda, API'lerin mimarisi ve temel işlevleri hakkında bilgi edineceksiniz. Google Cloud Shell'de Cloud Storage API yöntemleri yapılandırıp çalıştırarak öğrendiklerinizi uygulamalı olarak pekiştireceksiniz. Bu laboratuvarı tamamlayarak API iletişimi, mimarisi ve kimlik doğrulamasıyla ilgili temel ilkeleri öğrenebilirsiniz. Bundan sonraki laboratuvar veya projelerde faydalanabileceğiniz uygulamalı API deneyimi de kazanacaksınız.

API nedir ve ne için kullanılır?

Verilere ve bilgi işlem kaynaklarına erişme olanağı, bir geliştiricinin verimliliğini çok büyük oranda artırır. Her bir programı, yöntemi veya veri kümesini sıfırdan derlemektense API kullanmak çok daha kolaydır. API'ler, özetleme ilkesi temelinde derlenir, yani bir API'yi kendi ortamınızda kullanmak için onun iç işleyişini veya tüm karmaşık ayrıntılarını anlamanıza gerek yoktur.

API'ler, geliştirici odaklı olarak tasarlandığından genellikle Grafik Kullanıcı Arayüzleri (GUI) barındırmaz. Ancak bu standardın istisnaları vardır. Google'ın API Gezgini adlı yeni aracı çeşitli Google API'lerini etkileşimli bir şekilde keşfetmenize olanak tanır (Daha fazla bilgi edinmek istiyorsanız bu konudan sonra API Gezgini: Qwik Start laboratuvarına göz atabilirsiniz).

Cloud APIs

Google, pek çok farklı alana ve sektöre uygulanabilecek API'ler sunar. API'ler çoğu zaman web geliştirme, makine öğrenimi, veri bilimi ve sistem yönetimi iş akışlarında kullanılır. Ancak bunlar, API'lerin kullanım alanlarından yalnızca birkaç tanesidir. Örneğin, AnyAPI'yi incelediğinizde, kullanabileceğiniz birçok API olduğunu görürsünüz.

Qwiklabs, bir laboratuvar örneği için yeni bir Google Cloud projesi sağladığında, hemen laboratuvarın görevleri üzerinde çalışmaya başlayabilmeniz için projede çoğu API arka planda etkinleştirilir. Qwiklabs dışında kendi projelerinizi oluşturursanız bazı API'leri kendiniz etkinleştirmeniz gerekir.

Google Cloud kullanıcısı olarak yetkinlik kazandıkça iş akışınızda daha çok API kullanacaksınız. Deneyimli kullanıcılar yerel ortamlarında neredeyse her zaman Cloud API'leri entegre eder, araçları ve hizmetleri çalıştırmak için nadiren Cloud konsolunu kullanır. Farklı dillerdeki çeşitli Google API'lerini uygulamalı olarak deneyimlemeniz için çok sayıda uygulamalı laboratuvar hazırladık.

Bu laboratuvarda, hangi Google API'lerinin kullanılabileceğini görmek için API Library'yi (API Kitaplığı) inceleyeceksiniz.

Hedefler

Bu laboratuvarda şunları öğreneceksiniz:

• Google API'leri
• API mimarisi
• HTTP protokolü ve yöntemleri
• Uç noktalar
• REST (Representational State Transfer - Temsili Durum Aktarımı) ve RESTful API'ler
• JSON (JavaScript Object Notation - JavaScript Nesne Gösterimi)
• API kimlik doğrulama hizmetleri

Ön koşullar

Bu laboratuvar giriş seviyesine uygundur. Yani API bilginizin veya Google API'lerini kullanma deneyiminizin çok az olduğu ya da hiç olmadığı varsayılır. Kabuk ortamlarına ve komut satırı arayüzü araçlarına aşina olmanız önerilir ancak zorunlu değildir. Cloud konsolu ve Cloud Storage'a aşina olmanız önerilir. Bu nedenle, bu laboratuvara başlamadan önce en azından şu laboratuvarları tamamlayın:

• Qwiklabs ve Google Cloud Turu
• Cloud Storage: Qwik Start - Cloud Konsolu

Hazır olduğunuzda aşağı kaydırın ve laboratuvar ortamınızı kurma adımlarını uygulayın.

Kurulum ve şartlar

Laboratuvarı Başlat düğmesini tıklamadan önce

Buradaki talimatları okuyun. Laboratuvarlar süreli olduğundan duraklatılamaz. Start Lab'i (Laboratuvarı başlat) tıkladığınızda başlayan zamanlayıcı, Google Cloud kaynaklarının ne süreyle kullanımınıza açık durumda kalacağını gösterir.

Bu uygulamalı laboratuvarı kullanarak, laboratuvar etkinliklerini simülasyon veya demo ortamı yerine gerçek bir bulut ortamında gerçekleştirebilirsiniz. Bunu yapabilmeniz için size yeni, geçici kimlik bilgileri verilir. Bu kimlik bilgilerini laboratuvar süresince Google Cloud'da oturum açmak ve Google Cloud'a erişmek için kullanabilirsiniz.

Bu laboratuvarı tamamlamak için gerekenler:

• Standart bir internet tarayıcısına erişim (Chrome Tarayıcı önerilir)

Not: Bu laboratuvarı çalıştırmak için tarayıcıyı gizli modda (önerilen) veya gizli tarama penceresinde açın. Aksi takdirde, kişisel hesabınızla öğrenci hesabınız arasında oluşabilecek çakışmalar nedeniyle kişisel hesabınızdan ek ücret alınabilir.

• Laboratuvarı tamamlamak için yeterli süre (Laboratuvarlar başlatıldıktan sonra duraklatılamaz.)

Not: Bu laboratuvar için yalnızca öğrenci hesabını kullanın. Farklı bir Google Cloud hesabı kullanırsanız bu hesaptan ödeme alınabilir.

Laboratuvarınızı başlatma ve Google Cloud Console'da oturum açma

1. Laboratuvarı Başlat düğmesini tıklayın. Laboratuvar için ödeme yapmanız gerekiyorsa ödeme yöntemini seçebileceğiniz bir iletişim kutusu açılır. Soldaki "Laboratuvar ayrıntıları" panelinde şunlar yer alır:

   • "Google Cloud konsolunu aç" düğmesi
   • Kalan süre
   • Bu laboratuvarda kullanmanız gereken geçici kimlik bilgileri
   • Bu laboratuvarda ilerlemek için gerekebilecek diğer bilgiler

2. Google Cloud Console'u aç'ı tıklayın (veya Chrome Tarayıcı'yı kullanıyorsanız sağ tıklayıp Bağlantıyı gizli pencerede aç'ı seçin).

   Laboratuvar, kaynakları çalıştırır ve sonra "Oturum aç" sayfasını gösteren başka bir sekme açar.

   İpucu: Sekmeleri ayrı pencerelerde, yan yana açın.

   Not: Hesap seçin iletişim kutusunu görürseniz Başka bir hesap kullan'ı tıklayın.

3. Gerekirse aşağıdaki kullanıcı adını kopyalayıp Oturum açın iletişim kutusuna yapıştırın.

   {{{user_0.username | "Username"}}}

   Kullanıcı adını "Laboratuvar ayrıntıları" panelinde de bulabilirsiniz.

4. İleri'yi tıklayın.

5. Aşağıdaki şifreyi kopyalayıp Hoş geldiniz iletişim kutusuna yapıştırın.

   {{{user_0.password | "Password"}}}

   Şifreyi "Laboratuvar ayrıntıları" panelinde de bulabilirsiniz.

6. İleri'yi tıklayın.

   Önemli: Laboratuvarın sizinle paylaştığı giriş bilgilerini kullanmanız gerekir. Google Cloud hesabınızın kimlik bilgilerini kullanmayın. Not: Bu laboratuvarda kendi Google Cloud hesabınızı kullanabilmek için ek ücret ödemeniz gerekebilir.

7. Sonraki sayfalarda ilgili düğmeleri tıklayarak ilerleyin:

   • Hükümler ve koşulları kabul edin.
   • Geçici bir hesap kullandığınızdan kurtarma seçenekleri veya iki faktörlü kimlik doğrulama eklemeyin.
   • Ücretsiz denemelere kaydolmayın.

Birkaç saniye sonra Google Cloud konsolu bu sekmede açılır.

Not: Google Cloud ürün ve hizmetlerine erişmek için gezinme menüsünü tıklayın veya Arama alanına hizmetin veya ürünün adını yazın.

Cloud Shell'i etkinleştirme

Cloud Shell, çok sayıda geliştirme aracı içeren bir sanal makinedir. 5 GB boyutunda kalıcı bir ana dizin sunar ve Google Cloud üzerinde çalışır. Cloud Shell, Google Cloud kaynaklarınıza komut satırı erişimi sağlar.

1. Google Cloud konsolunun üst kısmından Activate Cloud Shell (Cloud Shell'i etkinleştir) simgesini tıklayın.

2. Aşağıdaki pencereleri tıklayın:

   • Cloud Shell bilgi penceresinde devam edin.
   • Google Cloud API çağrıları yapmak için Cloud Shell'e kimlik bilgilerinizi kullanma yetkisi verin.

Bağlandığınızda kimliğiniz zaten doğrulanmıştır. Proje ise Project_ID'nize () göre ayarlanmıştır. Çıkış, bu oturum için Project_ID'yi tanımlayan bir satır içerir:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud, Google Cloud'un komut satırı aracıdır. Cloud Shell'e önceden yüklenmiştir ve sekmeyle tamamlamayı destekler.

3. (İsteğe bağlı) Etkin hesap adını şu komutla listeleyebilirsiniz:

gcloud auth list

4. Authorize'ı (Yetkilendir) tıklayın.

Çıkış:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (İsteğe bağlı) Proje kimliğini şu komutla listeleyebilirsiniz:

gcloud config list project

Çıkış:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Not: gcloud ile ilgili tüm belgeleri, Google Cloud'daki gcloud CLI'a genel bakış rehberinde bulabilirsiniz.

Projenizin bölgesini ayarlama

Projenizin bölgesini ayarlamak için aşağıdaki komutu çalıştırın:

gcloud config set compute/region {{{project_0.default_region | Region}}}

API'lerin işleyiş şekli

API mimarisi

API'ler (uygulama programlama arayüzü), programların birbiriyle iletişim kurmasına olanak tanıyan yöntemlerdir. Programların, etkin bir şekilde iletişim kurmak için veri aktarımını ve yorumlanmasını yöneten net bir protokole bağlı kalması gerekir. İnternet, API'lerin programlar arasında istek ve yanıt iletmek için kullandığı standart iletişim kanalıdır. Web tabanlı API'ler, bilgi alışverişi için temel mimari olarak istemci-sunucu modelini kullanır. İstemci, bilgi işlem kaynakları veya veri isteğinde bulunan bilgi işlem cihazıdır. Sunucu ise verilerin ve/veya bilgi işlem kaynaklarının depolandığı yerdir. Sunucu, istemcinin isteğini yorumlayıp yerine getirir.

HTTP protokolü ve yöntemleri

API'ler iletişim kanalı olarak web'i kullandığından çoğu API, istemciler ve sunucular arasında internet üzerinden yapılan veri alışverişi için kurallar ve yöntemler belirten HTTP protokolüne bağlıdır. HTTP protokolünden yararlanan API'ler, istemci isteklerini sunuculara iletmek için HTTP istek yöntemlerini ("HTTP fiilleri" olarak da bilinir.) kullanır. En yaygın olarak kullanılan HTTP yöntemleri GET, POST, PUT ve DELETE'tir. GET yöntemi, sunucudan veri getirmek için istemci tarafından kullanılır. PUT yöntemi, mevcut verileri değiştirir veya veri yoksa veri oluşturur. POST yöntemi, en çok yeni kaynak oluşturmak için kullanılır. DELETE yöntemi, sunucuda istemci tarafından belirtilen verileri veya kaynakları kaldırır.

Uç noktalar

API'ler, sunucuda barındırılan verilerle veya bilgi işlem hizmetleriyle etkileşime geçmek için HTTP yöntemlerini kullanır. Belirli kaynaklara tutarlı olarak erişme yolu yoksa bu yöntemler işe yaramaz. API'ler, istemcilerin kaynaklara karmaşıklık veya düzensizlik olmadan erişebilmesi için uç nokta adı verilen iletişim kanallarını kullanır. Uç noktalar, sunucularda barındırılan veri veya bilgi işlem kaynağı erişim noktalarıdır ve HTTP URI'si biçimindedir. Uç noktalar, API'lerin ana URL'sine eklenerek belirli bir kaynağa veya kaynak kapsayıcısına giden bir yol oluşturur. Ayrıca API'lerin isteklerini tamamlamak için gereken değişkenleri geçirmek amacıyla uç noktalara sorgu dizeleri eklenebilir.

REST ve RESTful API'ler

HTTP protokolünden, istek yöntemlerinden ve uç noktalardan yararlanan API'ler, RESTful API olarak adlandırılır. RESTful API'ler sunucuda bulunur ve istemci istekleri için uygulayıcı rolünü üstlenir. Bu model, HTTP yöntemlerinin (fiillerin) davranışını belirleyen uç noktaların (özneler) çerçevesini tanımlar ve API'ler istekleri karşılamak için bu çerçeveyi kullanır. Özetlemek gerekirse RESTful API'ler, istemci-sunucu modelini kullanır, HTTP protokolüne uyar, HTTP istek yöntemlerinden yararlanır ve belirli kaynaklara erişmek için uç noktaları kullanır.

Öğrendiklerinizi test etme

Şimdiye kadar ele alınan kavramları pekiştirmek için aşağıdaki çoktan seçmeli soruları yanıtlayın.

1. görev: API kitaplığını kullanma

Bu bölümde API kitaplığını keşfedecek ve bir API'yi etkinleştireceksiniz. API kitaplığı, tüm Google API'lerinin merkezi konumudur. API kitaplığını kullanarak projelerinizdeki API'leri etkinleştirebilir, devre dışı bırakabilir ve yönetebilirsiniz.

1. Gezinme menüsünü açıp APIs & Services > Library'yi (API'ler ve Hizmetler > Kitaplık) seçin.

API kitaplığı 200'den fazla Google API'si için hızlı erişim, doküman ve yapılandırma seçeneği sunar. Konsolda barındırılsa da kitaplığın yalnızca Google Cloud merkezli olanlara değil, tüm Google API'lerine erişim sunduğunu unutmamakta fayda vardır. Bu, önemli bir durumu vurgular: API'ler tüm Google hizmetlerinde esastır ve Cloud APIs altında yer alanların tümü Google Cloud kategorisine girmez.

Şimdi API kitaplığında API etkinleştirmeyi uygulamalı olarak görelim. Bir fitness sitesinin mobil uygulama geliştiricisi olduğunuzu ve uygulamanızı derlemek için Google Fitness API'yi kullanmak istediğinizi düşünün.

2. Search for APIs and Service (API ve hizmet arayın) arama çubuğuna Fitness API yazıp ENTER tuşuna basın.
3. Sonuç listesinde Fitness API'yi tıklayın. Ardından Enable'ı (Etkinleştir) tıklayın.

Fitness API sayfası açılır ve API Status (Durum), Enabled (Etkin) olarak gösterilir.

API kitaplığında, eğitici içeriklere ve belgelere yönlendiren bağlantıların yanı sıra hizmet şartları ve API Gezgini'ndeki etkileşimli yöntemler yer alır. Metrik ve kullanım bilgilerini görmek için APIs & Services (API'ler ve Hizmetler) kontrol panelini kullanabilirsiniz. Bu sayfada kotaları görüntüleyebilir, kota isteyebilir, kaynak ve verilere erişimi kontrol edebilir, metrikleri görüntüleyebilirsiniz.

4. Bu özelliklerin işleyiş şeklini görmek için QUOTAS & SYSTEM LIMITS (KOTALAR VE SİSTEM SINIRLARI) sekmesini seçin.

5. İlgili API'nin günde ve dakikada kaç adet sorguya izin verdiğini burada görebilirsiniz.

Artık Cloud API olmayan bir API'nin temel hazırlığını yaptınız. Sonraki bölümlerde, API'lerin mimarisi ve temel işlevleri hakkında bilgi edineceksiniz. Ardından Cloud Storage API'yi kullanma alıştırması yapacaksınız.

Öğrendiklerinizi test etme

Şimdiye kadar ele alınan kavramları pekiştirmek için aşağıdaki çoktan seçmeli soruları yanıtlayın.

2. görev: Cloud konsolunda JSON dosyası oluşturma

Öğrendiklerinizi uygulamak için Cloud Shell'de Cloud Storage REST/JSON API çağrıları yaparak paket oluşturun ve içerik yükleyin.

1. Cloud Storage API'nin etkinleştirildiğinden emin olmak için yeni bir sekmede Google Cloud Storage JSON API'yi açın. API'nin etkinleştirildiğine dikkat edin.

2. Cloud Shell'de aşağıdaki komutu çalıştırarak values.json adlı bir dosya oluşturun ve düzenleyin:

nano values.json

3. nano metin düzenleyicide aşağıdakini kopyalayıp yapıştırın. Paket, benzersiz bir paket adına sahip olmalıdır. Bu nedenle paket adında proje kimliği kullanılır:

{ "name": "{{{project_0.project_id | Project_ID}}}-bucket", "location": "us", "storageClass": "multi_regional" } Not: Küresel olarak benzersiz olduğu için proje kimliğinizi paket adı olarak kullanabilirsiniz.

4. İşlemi tamamladıktan sonra CTRL+X, Y ve ardından ENTER tuşlarına basarak nano metin düzenleyiciden çıkın.

Böylece şu üç anahtar/değer çiftine sahip nesneyi barındıran bir JSON dosyası oluşturdunuz: name, location ve storageClass. Bunlar, gsutil komut satırı aracıyla veya konsolda paket oluştururken gereken değerlerdir.

Cloud Storage REST/JSON API ile paket oluşturabilmek için öncelikle kimlik doğrulama ve yetkilendirme konusunda doğru politikaları uygulamanız gerekir.

3. görev: Cloud Storage JSON/REST API kimliğini doğrulama ve yetkilendirme

Kimlik doğrulama ve yetkilendirme

Kimlik doğrulama ve yetkilendirme, genellikle birbirinin yerine kullanılan iki terimdir ancak aynı anlama gelmezler.

• Kimlik doğrulama, istemcinin kimliğini belirleme işlemidir.
• Yetkilendirme, kimliği doğrulanan istemcinin bir kaynak kümesi için hangi izinlere sahip olduğunu belirleme işlemidir.

Kimlik doğrulama kim olduğunuzu, yetkilendirme ise ne yapabileceğinizi belirler.

Google API'lerinin kullandığı üç tür kimlik doğrulama/yetkilendirme hizmeti vardır. Bunlar "API anahtarları", "hizmet hesapları" ve "OAuth"tur. API'ler, istenen kaynaklara ve kendilerine nereden çağrı yapıldığına bağlı olarak bu kimlik doğrulama hizmetlerinden birini kullanır.

API anahtarları

API anahtarları, genellikle şifrelenmiş bir dize formunda gelen gizli jetonlardır. API anahtarları hızla oluşturulup kullanılabilir. Herkese açık verileri veya yöntemleri kullanan ve geliştiricilerin hızla çalışmaya başlamasını amaçlayan API'lerde kullanıcıların kimliğini doğrulamak için genellikle API anahtarları kullanılır.

Google Cloud terimleriyle konuşmak gerekirse API anahtarları, API'ye çağrı yapan projeyi belirler. API anahtarları, çağrı yapan projeyi belirleyerek kullanım bilgilerinin projeyle ilişkilendirilmesini sağlar; erişim izni olmayan veya API tarafından etkinleştirilmemiş olan projelerin gönderdiği çağrıları reddedebilir.

OAuth

OAuth jetonları biçim olarak API anahtarlarına benzerdir ancak daha güvenlidirler ve kullanıcı hesaplarına veya kimliklerine bağlanabilirler. Bu jetonlar genellikle API'ler, bir geliştiriciye kullanıcı verilerine erişme olanağı verdiğinde kullanılır.

API anahtarları geliştiricilere bir API'nin tüm işlevleri için erişim verirken OAuth istemci kimlikleri tamamen kapsam temellidir, farklı kimliklere farklı ayrıcalıklar verilir.

Hizmet hesapları

Hizmet hesabı, tek bir son kullanıcıya değil, uygulamanıza veya bir sanal makineye ait olan özel bir Google Hesabı türüdür. Uygulamanız Google API'lerine çağrı yapmak için hizmet hesabı kimliğini üstlenir; yani kullanıcılar bu işleme doğrudan dahil değildir.

Hizmet hesaplarını kullanmak için hesabın özel anahtarını uygulamanıza sağlayabilir veya uygulamanızı Cloud Functions, Google App Engine, Compute Engine ya da Google Kubernetes Engine üzerinde çalıştırırken yararlanabileceğiniz yerleşik hizmet hesaplarını kullanabilirsiniz.

Özel olarak hizmet hesaplarına ve rollere odaklanılan bir laboratuvar için Hizmet Hesapları ve Roller: Temel Bilgiler'e göz atın.

Cloud Storage, kullanıcı verilerini barındıran ve bu verilere erişim sağlayan bir platformdur. Bu nedenle, Cloud Storage hizmetlerini kullanmadan önce bir OAuth jetonu oluşturmanız gerekir.

1. OAuth 2.0 Playground'u yeni bir sekmede açın. Bu, OAuth jetonlarını kolaylıkla oluşturmanızı sağlayan bir hizmettir.

2. Aşağı kaydırın ve Cloud Storage API V1'i seçin.

3. Ardından https://www.googleapis.com/auth/devstorage.full_control kapsamını seçin.

4. Authorize APIs (API'leri yetkilendir) yazan mavi kutuyu tıklayın. Bu işlem, Google ile Oturum Açma sayfasını açar.

5. Kullanıcı adınızı seçin ve daha sonra izin istendiğinde Allow'u (İzin ver) tıklayın.

OAuth 2.0 Playground açılır. 2. adımda yetkilendirme kodunun oluşturulduğunu göreceksiniz.

6. Exchange authorization code for tokens'ı (Jetonlar için yetkilendirme kodu değiş tokuşu yap) tıklayın. 3. adıma götürülürseniz 2. adım panelini tıklayın.

7. Sonraki adımda kullanmak için erişim jetonunu kopyalayın.

4. görev: Cloud Storage JSON/REST API ile paket oluşturma

1. Cloud Shell oturumunuza dönün. CLI isteminde ls yazın ve Enter tuşuna basın. Önceden oluşturduğunuz values.json dosyasını ve bir README-cloudshell.txt dosyasını görürsünüz:

Çıkış:

README-cloudshell.txt values.json

2. OAuth2 jetonunuzu ortam değişkeni olarak ayarlamak için <YOUR_TOKEN> kısmını oluşturduğunuz erişim jetonuyla değiştirerek aşağıdaki komutu çalıştırın:

export OAUTH2_TOKEN=<YOUR_TOKEN>

3. Proje kimliğini ortam değişkeni olarak ayarlamak için aşağıdaki komutu çalıştırın:

export PROJECT_ID=$(gcloud config get-value project)

4. Şimdi bir Cloud Storage paketi oluşturmak için aşağıdaki komutu çalıştırın:

curl -X POST --data-binary @values.json \ -H "Authorization: Bearer $OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://www.googleapis.com/storage/v1/b?project=$PROJECT_ID"

5. Şuna benzer bir çıkış alırsınız:

{ "kind": "storage#bucket", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-gcp-02-5d551758b5a7", "id": "qwiklabs-gcp-02-5d551758b5a7", "name": "qwiklabs-gcp-02-5d551758b5a7", "projectNumber": "670840659006", "metageneration": "1", "location": "US", "storageClass": "MULTI_REGIONAL", "etag": "CAE=", "timeCreated": "2020-11-11T06:41:40.901Z", "updated": "2020-11-11T06:41:40.901Z", "iamConfiguration": { "bucketPolicyOnly": { "enabled": false }, "uniformBucketLevelAccess": { "enabled": false } }, "locationType": "multi-region" } Not: "Use of this bucket name is restricted" (Bu grup adının kullanımı kısıtlandı) veya "Sorry, that name is not available" (Maalesef bu ad kullanılamıyor) gibi bir hata mesajı aldıysanız evrensel grup adlandırma kuralıyla bir uyuşmazlık durumu vardır. values.json dosyasını düzenleyin ve paket adını değiştirin.

Bu istek, şimdiye kadar öğrendiğiniz her şeyin özetidir. curl CLI aracını kullanarak bir HTTP POST yöntemi isteği yaptınız. values.json dosyasını istek içeriğine ilettiniz. OAuth jetonunu ve JSON spesifikasyonunu istek başlıkları olarak ilettiniz. Bu istek, proje kimliğiniz olarak ayarlı bir sorgu dizesi parametresini barındıran Cloud Storage uç noktasına yönlendirildi.

Yeni oluşturulan Cloud Storage paketinizi görüntüleme

• Yeni oluşturulan paketinizi görüntülemek için gezinme menüsünden Cloud Storage > Buckets'ı (Cloud Storage > Paketler) seçin.

Tamamlanan görevi test etme

Tamamladığınız görevi doğrulamak için Check my progress'i (İlerleme durumumu kontrol et) tıklayın. Cloud Storage JSON/REST API ile başarılı bir şekilde paket oluşturduysanız değerlendirme puanı güncellenir.

Cloud Storage JSON/REST API ile paket oluşturma

5. görev: Cloud Storage JSON/REST API kullanarak dosya yükleme

Paketlere dosya yüklemek için Cloud Storage JSON/REST API'yi kullanabilirsiniz.

1. Aşağıdaki resmi bilgisayarınıza kaydedin ve demo-image.png olarak adlandırın:

2. Cloud Shell oturumunuzda, sağ üst köşedeki üç nokta menü simgesini tıklayın. Upload (Yükle) > Choose File'ı (Dosya Seçin) tıklayın. demo-image.png dosyasını seçip yükleyin. Bu işlemde resim, dizininize eklenir.

3. Resim dosyasının yolunu almak için aşağıdaki komutu çalıştırın:

realpath demo-image.png

Şuna benzer bir çıkış alırsınız:

/home/gcpstaging25084_student/demo-image.png

4. Aşağıdaki komutta <DEMO_IMAGE_PATH> kısmını önceki komutun çıkışıyla değiştirip bu komutu çalıştırarak dosya yolunu ortam değişkeni olarak ayarlayın:

export OBJECT=<DEMO_IMAGE_PATH>

5. Aşağıdaki komutu çalıştırarak paket adınızı ortam değişkeni olarak ayarlayın:

export BUCKET_NAME={{{project_0.project_id | Project_ID}}}-bucket

6. Şimdi demo resmi Cloud Storage paketinize yüklemek için aşağıdaki komutu çalıştırın:

curl -X POST --data-binary @$OBJECT \ -H "Authorization: Bearer $OAUTH2_TOKEN" \ -H "Content-Type: image/png" \ "https://www.googleapis.com/upload/storage/v1/b/$BUCKET_NAME/o?uploadType=media&name=demo-image"

Şuna benzer bir çıkış alırsınız:

{ "kind": "storage#object", "id": "qwiklabs-gcp-02-5d551758b5a7/demo-image/1605077118178936", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-gcp-02-5d551758b5a7/o/demo-image", "mediaLink": "https://www.googleapis.com/download/storage/v1/b/qwiklabs-gcp-02-5d551758b5a7/o/demo-image?generation=1605077118178936&alt=media", "name": "demo-image", "bucket": "qwiklabs-gcp-02-5d551758b5a7", "generation": "1605077118178936", "metageneration": "1", "contentType": "image/png", "storageClass": "MULTI_REGIONAL", "size": "401951", "md5Hash": "LbpHpwhnApQKQx9IEXjTsQ==", "crc32c": "j5oPrg==", "etag": "CPis3Zvy+ewCEAE=", "timeCreated": "2020-11-11T06:45:18.178Z", "updated": "2020-11-11T06:45:18.178Z", "timeStorageClassUpdated": "2020-11-11T06:45:18.178Z" }

7. Resmin paketinize eklendiğini görmek için gezinme menüsünü açın ve Cloud Storage > Buckets'ı (Cloud Storage > Paketler) seçin.

8. demo-image kodunun eklendiğini görmek için paketinizin adını tıklayın:

9. Object details (Nesne ayrıntıları) sayfasını açmak için resim adını tıklayın.

Tamamlanan görevi test etme

Tamamladığınız görevi doğrulamak için Check my progress'i (İlerleme durumumu kontrol et) tıklayın. Cloud Storage JSON/REST API kullanarak başarılı bir şekilde dosya yüklediyseniz değerlendirme puanı güncellenir.

Cloud Storage JSON/REST API kullanarak dosya yükleme

Tebrikler!

Bu laboratuvarda API'lerle ilgili güçlü bir kavrayış geliştirdiniz ve Cloud Storage JSON/REST API'yi uygulamalı olarak deneyimlediniz. Cloud APIs, API mimarisi, HTTP protokolü ve yöntemleri, uç noktalar, RESTful API'ler, JSON ve API kimlik doğrulama uygulamaları hakkında bilgi edindiniz. Artık Qwiklabs'de daha fazla API laboratuvarına katılmaya hazırsınız.

Sonraki adımlar / Daha fazla bilgi

Daha fazla API deneyimi edinmek için aşağıdaki laboratuvarlara mutlaka göz atın:

• API Gezgini: Qwik Start
• Cloud Natural Language API: Qwik Start

Google Cloud eğitimi ve sertifikası

...Google Cloud teknolojilerinden en iyi şekilde yararlanmanıza yardımcı olur. Derslerimizde teknik becerilere odaklanırken en iyi uygulamalara da yer veriyoruz. Gerekli yetkinlik seviyesine hızlıca ulaşmanız ve öğrenim maceranızı sürdürebilmeniz için sizlere yardımcı olmayı amaçlıyoruz. Temel kavramlardan ileri seviyeye kadar farklı eğitim programlarımız mevcut. Ayrıca, yoğun gündeminize uyması için talep üzerine sağlanan, canlı ve sanal eğitim alternatiflerimiz de var. Sertifikasyonlar ise Google Cloud teknolojilerindeki becerilerinizi ve uzmanlığınızı doğrulamanıza ve kanıtlamanıza yardımcı oluyor.

Kılavuzun Son Güncellenme Tarihi: 26 Şubat 2024

Laboratuvarın Son Test Edilme Tarihi: 26 Şubat 2024

Telif Hakkı 2026 Google LLC. Tüm hakları saklıdır. Google ve Google logosu, Google LLC şirketinin ticari markalarıdır. Diğer tüm şirket ve ürün adları ilişkili oldukları şirketlerin ticari markaları olabilir.