با Perspective API شروع کنید

با Perspective API شروع کنید

درباره این codelab

آخرین به‌روزرسانی: مارس ۱۰, ۲۰۲۲

نویسنده: Jigsaw

1. قبل از اینکه شروع کنی

Perspective API یک API رایگان است که به شما کمک می کند مکالمات آنلاین بهتری را میزبانی کنید. API از یادگیری ماشینی (ML) برای تجزیه و تحلیل رشته ای از متن و پیش بینی تأثیر درک شده ای که ممکن است بر مکالمه داشته باشد استفاده می کند.

در این کد لبه، API پرسپکتیو را تنظیم می کنید.

توجه: Perspective API برای آسان‌تر کردن تعدیل محتوا است. قرار نیست کاملاً جایگزین کار تصمیم گیرندگان انسانی شود.

چیزی که یاد خواهید گرفت

• یک رویکرد مبتنی بر هوش مصنوعی برای تعدیل که محتوا را در لحظه ایجاد علامت گذاری می کند.

آنچه شما نیاز دارید

• یک حساب Google برای دسترسی به Google Cloud
• سرعت اینترنت مناسب

2. شروع کنید

برای شروع، شما به یک پروژه Google Cloud برای احراز هویت درخواست های API خود نیاز دارید.

1. در Google Cloud Console، از یک پروژه موجود استفاده کنید.
2. در صورت لزوم، مراحل زیر را برای ایجاد یک پروژه جدید دنبال کنید:

• با حساب Google خود وارد شوید.
• کنسول Cloud را باز کنید.
• روی Create Project کلیک کنید یا منوی Select a Project را باز کنید و سپس روی New Project در گفتگو کلیک کنید.
• نام پروژه خود را بگذارید و سپس روی Create کلیک کنید.

اکنون پروژه در منوی کشویی ظاهر می شود.

درخواست دسترسی API

• برای درخواست دسترسی API، این فرم را تکمیل کنید.

در عرض یک ساعت، باید ایمیلی دریافت کنید که تأیید می کند می توانید API را در Google Cloud مشاهده و فعال کنید.

توجه: اگر ظرف یک روز کاری ایمیلی دریافت نکردید، دوباره فرم را تکمیل کنید یا با تیم پشتیبانی تماس بگیرید .

3. API را فعال کنید

• در Cloud Console، به صفحه نمای کلی Perspective API بروید و سپس روی Enable کلیک کنید.

4. کلید API را ایجاد کنید

1. در منوی پیمایش، روی APIs & Services > Credentials > Create Credentials > API Key کلیک کنید.

توجه : اگر از زبان سمت سرویس گیرنده مانند جاوا اسکریپت درخواست می کنید، کلید API شما در معرض همه بازدیدکنندگان قرار می گیرد. اکیداً توصیه می شود که درخواست را از طریق یک سرور پراکسی کنید و محدودیت های کلیدی را اعمال کنید تا کلید از دید مرورگرها پنهان شود و فقط سرور شما بتواند از آن کلید استفاده کند. برای اطلاعات بیشتر، نمونه ای از نحوه پروکسی درخواست از طریق سرور و توصیه های امنیتی کلید API بیشتر را ببینید.

کلید API شما باید در چند دقیقه کار کند، اما ممکن است تا یک ساعت طول بکشد. تا آن زمان ممکن است پیغام خطا دریافت کنید.

2. کلید API را کپی کنید.

5. نمونه درخواست ها

می توانید کتابخانه های سرویس گیرنده API را با کتابخانه های سرویس گیرنده Google API ایجاد کنید. این مثال ها به شما نشان می دهد که چگونه کتابخانه API خود را با برخی از رایج ترین زبان ها راه اندازی کنید.

1. درخواست AnalyzeComment .
2. یکی از این تماس‌های نمونه API را اجرا کنید تا مستقیماً از Perspective API امتیاز بگیرید.

روش AnalyzeComment یک درخواست API برای تجزیه و تحلیل فیلد comment.text برای requestedAttributes صادر می کند، در این مورد مدل TOXICITY .

3. کلید API خود را در قسمت API_KEY قرار دهید.

اگر ترجیح می‌دهید، می‌توانید از پرچم doNotStore استفاده کنید تا اطمینان حاصل کنید که همه نظرات ارسال شده به طور خودکار پس از بازگرداندن امتیازات حذف می‌شوند.

4. برای جزئیات مربوط به تمام فیلدهای درخواست و پاسخ، و همچنین مقادیر موجود برای requestedAttributes ، اسناد مرجع API را بخوانید.

ویژگی‌های آزمایشی ، مانند OBSCENE ، ATTACK_ON_COMMENTER، و SPAM وجود دارد که می‌توانید از آنها نیز استفاده کنید.

پایتون

این نمونه درخواست و پاسخ از نسخه پایتون کتابخانه Google API Client استفاده می کند.

1. کتابخانه کلاینت پایتون را نصب کنید.
2. این دستورات را اجرا کنید:

شما باید چیزی شبیه به این خروجی ببینید:

سلام دوستانه شما نمره سمیت پایینی دریافت کرد.

Node.js

این نمونه درخواست و پاسخ از نسخه Node.js کتابخانه Google API Client استفاده می کند.

1. کتابخانه مشتری Node.js را نصب کنید یا بسته npm googleapis را نصب کنید.
2. این دستورات را اجرا کنید:

شما باید چیزی شبیه به این خروجی ببینید:

حلقه

این نمونه درخواست و پاسخ از دستور cURL استفاده می کند. این دستور باید برای اکثر کاربران MacOS و Linux کار کند. ممکن است برای اجرای این دستور نیاز به نصب cURL داشته باشید.

• کلید API خود را جایگزین YOUR_KEY_HERE کنید.

در این پاسخ، فیلد attributeScores.TOXICITY.summaryScore.value Scores.TOXICITY.summaryScore.value امتیاز مدل سمیت را برای نظر می دهد. این نظر امتیاز 0.9 از 1.0 را دریافت کرده است.

6. تبریک می گویم

شما Perspective API را راه اندازی کرده اید!

بیشتر بدانید

• وب سایت Perspective API حاوی اطلاعات بیشتری درباره API، از جمله مطالعات موردی است.
• وب سایت توسعه دهندگان Perspective API حاوی اطلاعات بیشتری در مورد ویژگی ها، زبان ها و روش ها است. اگر می‌خواهید سریع شروع کنید، صفحه روش‌ها نحوه استفاده از روش‌های AnalyzeComment و SuggestCommentScore را توضیح می‌دهد.