Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

تقارير طلبات البحث

يحتوي Report على نتيجة تحليل حِزمة تطبيق واحدة ويتضمّن عمليات التحقّق من الامتثال ونتائج مراقبة البيانات. يمكن الوصول آليًا إلى جميع البيانات تقريبًا التي يتم تقديمها من خلال صفحتَي الامتثال ومراقبة البيانات في Checks Console، وذلك من خلال التقارير.

توفّر واجهة برمجة التطبيقات Checks طريقتَي Get وList عاديتَين للوصول إلى التقارير:

اختيار الحقول المطلوب عرضها

بما أنّ التقارير تحتوي على الكثير من البيانات، يتم عرض الحقلَين name وresultsUri فقط تلقائيًا. لعرض مجموعة مختلفة من الحقول، أدرِجها بشكل صريح في مَعلمة طلب البحث الخاصة بعنوان URL fields.

مثال:

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 أيضًا باسم قناع الحقل. اطّلِع على حقول الإخفاء لمعرفة المزيد.

في ما يلي المزيد من الأمثلة على أقنعة الحقول للطريقتَين Get وList:

إنجاز

التعبير	الناتج
`*`	تعرض هذه السمة جميع الحقول.
`name,checks`	تعرض هذه السمة `name` وجميع الحقول المضمّنة في `checks`.
`name,checks(type,state)`	تعرض هذه السمة `name` و`checks.type` و`checks.state`.
`name,dataMonitoring`	تعرض هذه السمة `name` وجميع الحقول المضمّنة في `dataMonitoring`.

قائمة

التعبير	الناتج
`*`	تعرض هذه السمة جميع الحقول.
`reports(name,checks)`	تعرض هذه السمة `name` وجميع الحقول المضمّنة في `checks`.
`reports(name,checks(type,state))`	تعرض هذه السمة `name` و`checks.type` و`checks.state`.
`reports(name,dataMonitoring)`	تعرض هذه السمة `name` وجميع الحقول المضمّنة في `dataMonitoring`.

فلترة التقارير

يمكنك فلترة التقارير التي تعرضها طريقة List من خلال تمرير تعبير فلترة باستخدام مَعلمة طلب البحث filter في عنوان URL.

وإليك بعض الأمثلة:

التعبير	الناتج
`appBundle.releaseType = PRE_RELEASE`	تعرِض هذه السمة تقارير حِزم التطبيقات التي لم يتم إصدارها بعد فقط.
`appBundle.releaseType = PUBLIC`	تعرِض هذه الطريقة تقارير حِزم التطبيقات المتاحة للجميع فقط.
`appBundle.codeReferenceId = abc123`	تعرِض هذه الدالة التقارير التي تكون فيها قيمة `codeReferenceId` مساوية لقيمة `abc123`.

لا يمكن الفلترة حسب مسارات الحقول التالية:

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.