ক্যোয়ারী রিপোর্ট

একটি Report একটি একক অ্যাপ বান্ডেল বিশ্লেষণের ফলাফল থাকে এবং এতে সম্মতি পরীক্ষা এবং ডেটা পর্যবেক্ষণের ফলাফল অন্তর্ভুক্ত থাকে। চেক কনসোলের কমপ্লায়েন্স এবং ডেটা মনিটরিং পৃষ্ঠাগুলির মাধ্যমে অফার করা প্রায় সমস্ত ডেটা রিপোর্টের মাধ্যমে প্রোগ্রাম্যাটিকভাবে অ্যাক্সেস করা যেতে পারে।

চেক এপিআই রিপোর্ট অ্যাক্সেস করার জন্য স্ট্যান্ডার্ড Get এবং List পদ্ধতি প্রদান করে:

• accounts.apps.reports.get
• accounts.apps.reports.list

কোন ক্ষেত্রগুলি ফিরতে হবে তা নির্বাচন করুন৷

কারণ রিপোর্টে প্রচুর ডেটা থাকে, শুধুমাত্র name এবং resultsUri ক্ষেত্রগুলি ডিফল্টরূপে ফেরত দেওয়া হয়৷ ক্ষেত্রগুলির একটি ভিন্ন সেট ফেরত দিতে, সেগুলিকে fields URL ক্যোয়ারী প্যারামিটারে স্পষ্টভাবে তালিকাভুক্ত করুন৷

উদাহরণ:

GET https://checks.googleapis.com/v1alpha/accounts/123/apps/456/reports/789?fields=name,checks(type,state)

রিটার্ন:

{
  "name": "accounts/123/apps/456/reports/789",
  "checks": [
    {
      "type": "PRIVACY_POLICY_UPDATE_DATE_RECENT",
      "state": "PASSED"
    },
    ...
  ]
}

নেস্টেড ক্ষেত্রগুলি ডট সিনট্যাক্স ব্যবহার করে বা বন্ধনীতে আবদ্ধ করে তালিকাভুক্ত করা যেতে পারে।

উদাহরণ স্বরূপ,

fields=checks.type,checks.state

এর সমতুল্য

fields=checks(type,state)

বন্ধনীগুলিও পুনরাবৃত্তিমূলকভাবে ব্যবহার করা যেতে পারে, যেমন:

fields=checks(type,state,evidence(permissions,sdks))

এই অভিব্যক্তি আরো সংক্ষিপ্ত হতে অনুমতি দেয়.

fields ক্যোয়ারী প্যারামিটারের মান একটি ফিল্ড মাস্ক হিসাবেও পরিচিত। আরও জানতে ফিল্ড মাস্ক দেখুন।

দ্রষ্টব্য: fields ক্যোয়ারী প্যারামিটারে তালিকাভুক্ত ফিল্ড পাথগুলি কল করা পদ্ধতির রিটার্ন প্রকারের সাথে অবশ্যই মিলবে৷ উদাহরণস্বরূপ, checks ক্ষেত্র নির্বাচন করার সময়, Get মেথড কল করার সময় fields=checks ব্যবহার করা উচিত যেখানে List পদ্ধতিতে কল করার সময় fields=reports(checks) ব্যবহার করা উচিত।

নীচে Get এবং List পদ্ধতির জন্য আরও ফিল্ড মাস্ক উদাহরণ রয়েছে:

পাওয়া

অভিব্যক্তি	আউটপুট
*	সমস্ত ক্ষেত্র ফেরত দেয়।
name,checks	name এবং checks সমস্ত নেস্টেড ক্ষেত্র ফেরত দেয়।
name,checks(type,state)	name , checks.type এবং checks.state প্রদান করে।
name,dataMonitoring	dataMonitoring name এবং সমস্ত নেস্টেড ক্ষেত্রগুলি প্রদান করে।

তালিকা

অভিব্যক্তি	আউটপুট
*	সমস্ত ক্ষেত্র ফেরত দেয়।
reports(name,checks)	name এবং checks সমস্ত নেস্টেড ক্ষেত্র ফেরত দেয়।
reports(name,checks(type,state))	name , checks.type এবং checks.state প্রদান করে।
reports(name,dataMonitoring)	dataMonitoring name এবং সমস্ত নেস্টেড ক্ষেত্রগুলি প্রদান করে।

ফিল্টার রিপোর্ট

আপনি filter URL ক্যোয়ারী প্যারামিটার ব্যবহার করে একটি ফিল্টার এক্সপ্রেশন পাস করে List পদ্ধতি দ্বারা প্রত্যাবর্তিত প্রতিবেদনগুলি ফিল্টার করতে পারেন।

এখানে কিছু উদাহরণঃ:

অভিব্যক্তি	আউটপুট
appBundle.releaseType = PRE_RELEASE	শুধুমাত্র প্রি-রিলিজ অ্যাপ বান্ডেলের রিপোর্ট প্রদান করে।
appBundle.releaseType = PUBLIC	শুধুমাত্র পাবলিক অ্যাপ বান্ডেলের রিপোর্ট প্রদান করে।
appBundle.codeReferenceId = abc123	রিপোর্ট প্রদান করে যেখানে codeReferenceId সমান abc123 ।

দ্রষ্টব্য: বারবার ফিল্ড দ্বারা ফিল্টার করার সময়, তুলনা করার জন্য আপনি শুধুমাত্র HAS অপারেটর (কোলন : অক্ষর দ্বারা চিহ্নিত) ব্যবহার করতে পারেন। আরও তথ্যের জন্য অপারেটর আছে দেখুন।

এই ক্ষেত্র পাথ দ্বারা ফিল্টারিং সমর্থিত নয়:

• checks.evidence.dataTypes.dataTypeEvidence.endpoints.attributedSdks.sdk.id
• checks.evidence.dataTypes.dataTypeEvidence.endpoints.endpointDetails.endpoint.domain
• checks.evidence.dataTypes.dataTypeEvidence.privacyPolicyTexts.policyFragment.htmlContent
• checks.evidence.privacyPolicyTexts.policyFragment.htmlContent
• checks.evidence.sdkIssues.sdk.id
• dataMonitoring.dataTypes.dataTypeEvidence.endpoints.attributedSdks.sdk.id
• dataMonitoring.dataTypes.dataTypeEvidence.endpoints.endpointDetails.endpoint.domain
• dataMonitoring.dataTypes.dataTypeEvidence.privacyPolicyTexts.policyFragment.htmlContent
• dataMonitoring.dataTypes.dataTypeEvidence.privacyPolicyTexts.policyFragment.sourceUri
• dataMonitoring.permissions.metadata.lastDetectedAppVersion
• resultsUri

আরও ফিল্টার এক্সপ্রেশন কীভাবে তৈরি করবেন তা শিখতে AIP-160 দেখুন।

রিপোর্টের মধ্যে ফিল্টার চেক

আপনি checksFilter URL ক্যোয়ারী প্যারামিটার ব্যবহার করে একটি ফিল্টার এক্সপ্রেশন পাস করে রিপোর্টের মধ্যে চেক ফিল্টার করতে পারেন। শুধুমাত্র ফিল্টার এক্সপ্রেশনের সাথে মেলে এমন চেকগুলি প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হয়েছে। এই প্যারামিটারটি List এবং Get উভয় পদ্ধতি দ্বারা সমর্থিত।

এখানে কিছু উদাহরণঃ:

অভিব্যক্তি	আউটপুট
state = FAILED	শুধুমাত্র ব্যর্থ চেক অন্তর্ভুক্ত.
citations.type:GDPR	শুধুমাত্র জিডিপিআর সম্পর্কিত চেক অন্তর্ভুক্ত।
state = FAILED AND citations.type:GDPR	জিডিআরপি সম্পর্কিত শুধুমাত্র ব্যর্থ চেক অন্তর্ভুক্ত।
regionCodes:CA	শুধুমাত্র কানাডা অঞ্চলের সাথে সম্পর্কিত চেক অন্তর্ভুক্ত করে।
state = FAILED AND severity = PRIORITY	শুধুমাত্র ব্যর্থ অগ্রাধিকার চেক অন্তর্ভুক্ত.

দ্রষ্টব্য: বারবার ফিল্ড দ্বারা ফিল্টার করার সময়, তুলনা করার জন্য আপনি শুধুমাত্র HAS অপারেটর (কোলন : অক্ষর দ্বারা চিহ্নিত) ব্যবহার করতে পারেন। আরও তথ্যের জন্য অপারেটর আছে দেখুন।

এই ক্ষেত্র পাথ দ্বারা ফিল্টারিং সমর্থিত নয়:

• evidence.dataTypes.dataTypeEvidence.endpoints.attributedSdks.sdk.id
• evidence.dataTypes.dataTypeEvidence.endpoints.endpointDetails.endpoint.domain
• evidence.dataTypes.dataTypeEvidence.privacyPolicyTexts.policyFragment.htmlContent
• evidence.privacyPolicyTexts.policyFragment.htmlContent
• evidence.sdkIssues.sdk.id

আরও ফিল্টার এক্সপ্রেশন কীভাবে তৈরি করবেন তা শিখতে AIP-160 দেখুন।

পৃষ্ঠা সংখ্যা

ডিফল্টরূপে, List পদ্ধতি সর্বাধিক 10 রিপোর্ট প্রদান করে। আপনি pageSize URL ক্যোয়ারী প্যারামিটার সেট করে এটি পরিবর্তন করতে পারেন। সর্বোচ্চ মান 50 ।

List পদ্ধতি একটি nextPageToken ফেরত দেয় যখন আনার জন্য আরও ফলাফল থাকে:

{
  "reports": [
    ...
  ],
  "nextPageToken": "CAEQ0ITI8K7ngAMaIDY3MThjNjQ3NGZmNzBhZGI4NWI5NjAyN2ViZmQ5MWVh"
}

ফলাফলের পরবর্তী পৃষ্ঠা আনতে pageToken URL ক্যোয়ারী প্যারামিটার ব্যবহার করে List পদ্ধতিতে এই টোকেনটি পাস করুন।