Android Developer Console API

Android Developer Console API হল একটি RESTful পরিষেবা যা যাচাইকৃত ডেভেলপারদের Android Developer Console-এ Android ডেভেলপার যাচাইকরণ ওয়ার্কফ্লো অটোমেট করতে দেয়, যার মধ্যে ডেভেলপার অ্যাকাউন্ট ফিরিয়ে আনা, কী-এর যোগ্যতার প্রয়োজনীয়তা চেক করা, Android প্যাকেজের নাম রেজিস্টার করা, অ্যাপ সাইনিং কী রেজিস্টার করা এবং কী-এর মালিকানা যাচাই করা অন্তর্ভুক্ত।

ওভারভিউ, ব্যবহারের উদাহরণ ও প্রয়োগের প্রসঙ্গ

মূল ব্যবহারিক ক্ষেত্র ও ফিচার

• অটোমেটেড CI/CD প্যাকেজের নাম রেজিস্ট্রেশন: প্রোগ্রাম্যাটিকভাবে (CreateAndroidPackage) ডজন বা শত শত Android প্যাকেজের নাম রেজিস্টার করুন।
• প্রি-ফ্লাইট হিস্টোরিক্যাল কী পলিসি ইন্সপেকশন: Google আগে ইকোসিস্টেমে কোনও প্যাকেজের নাম লক্ষ্য করেছে কিনা এবং কোনও নির্দিষ্ট সাইনিং সার্টিফিকেট রেজিস্টার করার জন্য কী-এর মালিকানা যাচাইকরণ (GetAndroidPackageRegistrationPolicy) প্রয়োজন কিনা তা প্রোগ্রাম্যাটিকভাবে পরীক্ষা করুন।
• অটোমেটিক অ্যাপ সাইনিং কী রেজিস্ট্রেশন ও মালিকানা যাচাইকরণ: পাবলিক সাইনিং সার্টিফিকেট SHA-256 ফিঙ্গারপ্রিন্ট রেজিস্টার করুন (CreateAndroidPackageKey), অনন্য যাচাইকরণ চ্যালেঞ্জ টোকেন ফিরিয়ে আনুন (verificationToken) এবং সিঙ্গল-রিকোয়েস্ট বা রিজুম করা যায় এমন সাইন করা APK আপলোড ব্যবহার করে ব্যক্তিগত কী পজেশন অটোমেট করুন (VerifyAndroidPackageKeyOwnership)।
• প্রোগ্রামাটিক জাস্টিফিকেশন জমা দেওয়া: মালিকানার জাস্টিফিকেশন জমা দিন (JustifyAndroidPackageKeyRegistration)।
• স্ট্যাটাস মনিটর করা: ডেভেলপার অ্যাকাউন্ট, প্যাকেজের নাম ও অ্যাপ সাইনিং কী (GetDeveloperAccount, ListDeveloperAccounts, GetAndroidPackage, ListAndroidPackages, GetAndroidPackageKey, ListAndroidPackageKeys) জুড়ে রেজিস্ট্রেশন স্ট্যাটাস মনিটর করুন।

এন্ড-টু-এন্ড প্রয়োগের ওয়ার্কফ্লো

1. UI-তে একবার ডেভেলপারের পরিচয় যাচাই করুন: Android Developer Console-এ ডেভেলপারের পরিচয় যাচাইকরণ (INDIVIDUAL বা ORGANIZATION) সম্পূর্ণ করুন যাতে verificationState, VERIFIED হয়।
2. API চালু ও যাচাই করুন: আপনার Google Cloud প্রোজেক্টে androiddeveloperconsole.googleapis.com চালু করুন এবং https://www.googleapis.com/auth/androiddeveloperconsole স্কোপ সহ ব্যবহারকারী-প্রতিনিধি OAuth 2.0 বিয়ারার অ্যাক্সেস টোকেন পান।
3. আপনার ডেভেলপার অ্যাকাউন্ট রিসোর্সের নাম খুঁজে নিন: GET /v1/developerAccounts (ListDeveloperAccounts) কল করে developerAccounts/{developer_account} ফিরিয়ে আনুন এবং যাচাই করুন যে verificationState হল VERIFIED।
4. প্যাকেজের নামের জন্য রেজিস্ট্রেশন নীতি চেক করুন: keySelectionStrategy (SELECT_KEY_FROM_LIST অথবা USE_ANY_KEY) এবং আগে থেকে জানা কোনও ঐতিহাসিক সাইনিং কী (knownKeys) পরীক্ষা করতে GET /v1/developerAccounts/{id}/androidPackages/{pkg}/registrationPolicy (GetAndroidPackageRegistrationPolicy) কল করুন।
5. Android প্যাকেজ রিসোর্স তৈরি করুন: {"name": ""} বডি সহ POST /v1/developerAccounts/{id}/androidPackages?androidPackageId={pkg} (CreateAndroidPackage) কল করুন (DRAFT স্টেটে রিসোর্স তৈরি করে)।
6. আপনার অ্যাপ সাইনিং কী ফিঙ্গারপ্রিন্ট রেজিস্টার করুন: JSON বডি {"certificateFingerprintSha256": "..."} সহ POST /v1/developerAccounts/{id}/androidPackages/{pkg}/keys (CreateAndroidPackageKey) কল করুন। ফেরত আসা স্টেট ভালোভাবে দেখুন:
   • DRAFT: ব্যক্তিগত কী-এর মালিকানার প্রমাণ প্রয়োজন এবং উত্তরে ৭ নম্বর ধাপের জন্য একটি অনন্য verificationToken অন্তর্ভুক্ত থাকে।
   • IN_REVIEW: মালিকানার প্রমাণ এবং যুক্তি অটোমেটিক এড়িয়ে যাওয়া হয় (যেমন, Android-এ কখনও দেখা যায়নি এমন একটি নতুন প্যাকেজের নাম রেজিস্টার করার সময়, অথবা আপনি যখন একই DeveloperAccount-এ অন্য প্যাকেজের নামের জন্য এই সাইনিং কী-এর মালিকানা ইতিমধ্যে যাচাই করেছেন)। ধাপ ৭ এবং ধাপ ৮-এ যুক্তি কল এড়িয়ে যান, এবং সরাসরি পোলিং GetAndroidPackage এবং GetAndroidPackageKey-এ এগিয়ে যান।
7. যাচাইকরণ APK তৈরি ও আপলোড করুন (স্ট্যাটাস DRAFT হলে): packageName-এর সাথে ম্যাচ করে এমন একটি মিনিমাল APK-এর মধ্যে assets/adi-registration.properties-এ ফিরে আসা verificationToken স্ট্রিং এম্বেড করুন, আপনার ব্যক্তিগত অ্যাপ সাইনিং কী দিয়ে এটি সাইন করুন এবং POST /upload/v1/developerAccounts/{id}/androidPackages/{pkg}/keys/{sha256}:verify (VerifyAndroidPackageKeyOwnership) ব্যবহার করে এটি আপলোড করুন।
8. যুক্তি জমা দিন (প্রয়োজন হলে) এবং পোল রেজিস্ট্রেশন স্ট্যাটাস: যদি কী OWNERSHIP_VERIFIED স্ট্যাটাসে থাকে এবং registrationJustificationRequired true হয়, তাহলে POST /v1/developerAccounts/{id}/androidPackages/{pkg}/keys/{sha256}:justifyAndroidPackageKeyRegistration (JustifyAndroidPackageKeyRegistration)-এ কল করুন। state, REGISTERED-এ না পৌঁছানো পর্যন্ত GetAndroidPackage এবং GetAndroidPackageKey পোল করুন।

কী ফিঙ্গারপ্রিন্ট ও যাচাইকরণ APK প্রস্তুত করার জন্য লোকাল CLI কমান্ড

• কিস্টোর (keytool) থেকে SHA-256 সার্টিফিকেট ফিঙ্গারপ্রিন্ট এক্সট্র্যাক্ট করুন:

  keytool -list -v -keystore release-key.jks -alias my-key-alias

• তৈরি করা APK-তে (apksigner) SHA-256 সাইনিং সার্টিফিকেট ডাইজেস্ট যাচাই করুন:

  apksigner verify --print-certs app-release.apk

• আপলোড করার আগে APK প্যাকেজের নাম এবং এম্বেড করা টোকেন ফাইল চেক করুন (aapt2 এবং unzip):

  aapt2 dump badging app-release.apk | head -n 1
  unzip -p app-release.apk assets/adi-registration.properties

Android Developer Console UI এবং API-এর ক্ষমতা

পরিষেবা কনফিগারেশন ও যাচাইকরণ

সব API অনুরোধে HTTPS ব্যবহার করতে হবে এবং Android Developer Console-এ ডেভেলপারের পরিচয় যাচাইকরণ সম্পূর্ণ করেছে এমন Google অ্যাকাউন্টের জন্য OAuth 2.0 ওয়েব সার্ভার ফ্লো ব্যবহার করে পাওয়া Authorization: Bearer ACCESS_TOKEN হেডার অন্তর্ভুক্ত করতে হবে।

API রিসোর্স ও এন্ডপয়েন্ট

Android Developer Console API নিম্নলিখিত ক্রম অনুযায়ী রিসোর্স সাজায়:

• DeveloperAccount (developerAccounts/{developer_account})
  • AndroidPackage (developerAccounts/{developer_account}/androidPackages/{android_package})
    • AndroidPackageRegistrationPolicy (developerAccounts/{developer_account}/androidPackages/{android_package}/registrationPolicy)
    • AndroidPackageKey (developerAccounts/{developer_account}/androidPackages/{android_package}/keys/{key}টি)

রিসোর্স: DeveloperAccount

Android Developer Console-এ কোনও অ্যাকাউন্টকে বোঝায় যা কোনও ডেভেলপারের পরিচয়ের সাথে যুক্ত।

Enum: DeveloperAccount.VerificationState

Methods: DeveloperAccount

রিসোর্স: AndroidPackage

DeveloperAccount-এর অধীনে রেজিস্টার করা হয়েছে বা হচ্ছে এমন Android প্যাকেজের নাম দেখায়।

Enum: AndroidPackage.State

রিসোর্স: AndroidPackageRegistrationPolicy

GetAndroidPackageRegistrationPolicy দ্বারা রিটার্ন করা সিঙ্গলটন রিসোর্স যা কোনও প্যাকেজের নামের জন্য শনাক্ত করা ঐতিহাসিক পাবলিক সাইনিং কী এবং প্রদত্ত সাইনিং কী সহ প্যাকেজের নাম রেজিস্টার করার জন্য লিখিত যুক্তি প্রয়োজন কিনা তা বর্ণনা করে।

Enum: KnownKey.JustificationRequirement

Enum: AndroidPackageRegistrationPolicy.KeySelectionStrategy

পদ্ধতি: AndroidPackage

রিসোর্স: AndroidPackageKey

AndroidPackage-এর সাথে যুক্ত পাবলিক অ্যাপ সাইনিং সার্টিফিকেট ফিঙ্গারপ্রিন্ট দেখায় এবং মালিকানা যাচাইকরণ ও রেজিস্ট্রেশন পর্যালোচনা স্ট্যাটাস ট্র্যাক করে।

Enum: AndroidPackageKey.State

পদ্ধতি: AndroidPackageKey

সমস্যা ম্যানেজ করা

API অনুরোধ ব্যর্থ হলে, Android Developer Console API একটি HTTP 4xx বা 5xx স্ট্যাটাস কোড এবং একটি স্ট্যান্ডার্ড google.rpc.Status JSON ত্রুটি বডি ফেরত দেয়:

{
  "error": {
    "code": 400,
    "message": "Invalid certificate fingerprint SHA256 format.",
    "status": "INVALID_ARGUMENT",
    "details": []
  }
}

HTTP স্ট্যাটাস কোড ও সাধারণ সমাধান

HTTP অনুরোধ ও উত্তরের উদাহরণ

ACCESS_TOKEN, 1234567890, com.example.myapp এবং 60e860e8...-এর মতো প্লেসহোল্ডার ভ্যালু আপনার নিজস্ব ভ্যালু দিয়ে পরিবর্তন করুন।

১. GetDeveloperAccount

curl -X GET \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts/1234567890"

উত্তর:

{
  "name": "developerAccounts/1234567890",
  "displayName": "Example Developer",
  "verificationState": "VERIFIED"
}

২. ListDeveloperAccounts

curl -X GET \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts"

উত্তর:

{
  "developerAccounts": [
    {
      "name": "developerAccounts/1234567890",
      "displayName": "Example Developer",
      "verificationState": "VERIFIED"
    }
  ]
}

৩. GetAndroidPackageRegistrationPolicy

curl -X GET \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts/1234567890/androidPackages/com.example.myapp/registrationPolicy"

উত্তর:

{
  "name": "developerAccounts/1234567890/androidPackages/com.example.myapp/registrationPolicy",
  "knownKeys": [
    {
      "certificateFingerprintSha256": "60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
      "justificationRequirement": "NOT_REQUIRED"
    }
  ],
  "keySelectionStrategy": "SELECT_KEY_FROM_LIST"
}

৪. CreateAndroidPackage

curl -X POST \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{"name": ""}' \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts/1234567890/androidPackages?androidPackageId=com.example.myapp"

উত্তর:

{
  "name": "developerAccounts/1234567890/androidPackages/com.example.myapp",
  "packageName": "com.example.myapp",
  "state": "DRAFT",
  "registeredAppStore": false
}

৫. GetAndroidPackage

curl -X GET \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts/1234567890/androidPackages/com.example.myapp"

উত্তর:

{
  "name": "developerAccounts/1234567890/androidPackages/com.example.myapp",
  "packageName": "com.example.myapp",
  "state": "REGISTERED",
  "registeredAppStore": false
}

৬. ListAndroidPackages

curl -X GET \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts/1234567890/androidPackages?pageSize=100"

উত্তর:

{
  "androidPackages": [
    {
      "name": "developerAccounts/1234567890/androidPackages/com.example.myapp",
      "packageName": "com.example.myapp",
      "state": "REGISTERED",
      "registeredAppStore": false
    }
  ],
  "nextPageToken": ""
}

৭. CreateAndroidPackageKey

curl -X POST \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "certificateFingerprintSha256": "60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123"
  }' \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts/1234567890/androidPackages/com.example.myapp/keys"

উত্তর:

{
  "name": "developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
  "certificateFingerprintSha256": "60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
  "state": "DRAFT",
  "verificationToken": "token_xyz987654321"
}

৮. GetAndroidPackageKey

curl -X GET \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123"

উত্তর:

{
  "name": "developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
  "certificateFingerprintSha256": "60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
  "state": "REGISTERED"
}

৯. ListAndroidPackageKeys

curl -X GET \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts/1234567890/androidPackages/com.example.myapp/keys?pageSize=100"

উত্তর:

{
  "androidPackageKeys": [
    {
      "name": "developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
      "certificateFingerprintSha256": "60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
      "state": "REGISTERED"
    }
  ],
  "nextPageToken": ""
}

১০. VerifyAndroidPackageKeyOwnership

বিকল্প ক: একটি অনুরোধের মাধ্যমে মিডিয়া আপলোড করা

curl -X POST \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @app-release.apk \
  "https://androiddeveloperconsole.googleapis.com/upload/v1/developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123:verify?uploadType=media"

বিকল্প খ: আপলোড আবার শুরু করার প্রোটোকল (বড় APK বা CI/CD-এর জন্য সাজেস্ট করা হয়)

ধাপ ১: আবার চালু করা যায় এমন আপলোড সেশন শুরু করুন এবং ফেরত আসা X-Goog-Upload-URL হেডার এক্সট্র্যাক্ট করুন:

curl -i -X POST \
  "https://androiddeveloperconsole.googleapis.com/upload/v1/developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123:verify" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-Goog-Upload-Protocol: resumable" \
  -H "X-Goog-Upload-Command: start" \
  -H "X-Goog-Upload-Header-Content-Length: FILE_SIZE_IN_BYTES" \
  -H "X-Goog-Upload-Header-Content-Type: application/vnd.android.package-archive" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123"
  }'

ধাপ ২: UPLOAD_SESSION_URI-এ সাইন করা APK বাইনারি আপলোড করুন এবং সেশন চূড়ান্ত করুন:

curl -X PUT \
  "UPLOAD_SESSION_URI" \
  -H "Content-Length: FILE_SIZE_IN_BYTES" \
  -H "X-Goog-Upload-Offset: 0" \
  -H "X-Goog-Upload-Command: upload, finalize" \
  --data-binary "@app-release.apk"

উত্তর:

{
  "name": "developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
  "certificateFingerprintSha256": "60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
  "state": "IN_REVIEW"
}

১১. JustifyAndroidPackageKeyRegistration

curl -X POST \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "justification": "We previously distributed com.example.myapp directly from https://downloads.example.com and are migrating to our rotated production key."
  }' \
  "https://androiddeveloperconsole.googleapis.com/v1/developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123:justifyAndroidPackageKeyRegistration"

উত্তর:

{
  "name": "developerAccounts/1234567890/androidPackages/com.example.myapp/keys/60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
  "certificateFingerprintSha256": "60e860e8d77251234567890abcdef1234567890abcdef1234567890abcdef123",
  "state": "IN_REVIEW",
  "registrationJustificationRequired": true
}

অতিরিক্ত রিসোর্স

• Android Developer Console API-এর মাধ্যমে প্যাকেজের নাম রেজিস্টার করা
• Android Developer ID Status API-এর মাধ্যমে অ্যাপ রেজিস্ট্রেশনের স্ট্যাটাস চেক করুন
• Android Developer Console-এ রেজিস্টার করা
• Google Play Console-এ রেজিস্টার করা