Mulai cepat: Mencari informasi operator untuk nomor telepon menggunakan Azure Communication Services

Artikel
04/04/2024

Penting

Fitur Azure Communication Services ini saat ini dalam pratinjau.

API pratinjau dan SDK disediakan tanpa perjanjian tingkat layanan. Kami menyarankan agar Anda tidak menggunakannya untuk beban kerja produksi. Beberapa fitur mungkin tidak didukung, atau mungkin memiliki kemampuan yang dibatasi.

Untuk informasi selengkapnya, tinjau Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Mulai menggunakan pustaka klien Telepon Numbers untuk JavaScript guna mencari informasi operator untuk nomor telepon, yang dapat digunakan untuk menentukan apakah dan cara berkomunikasi dengan nomor telepon tersebut. Ikuti langkah-langkah ini untuk menginstal paket dan mencari informasi operator tentang nomor telepon.

Catatan

Temukan kode untuk mulai cepat ini di GitHub.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Node.js Active LTS (dukungan jangka panjang) dan versi Maintenance LTS (8.11.1 dan 10.14.1 1 direkomendasikan).
Sumber daya Communication Services aktif dan string koneksi. Buat sumber daya Azure Communication Services.

Pemeriksaan prasyarat

Di terminal atau jendela perintah, jalankan node --version perintah untuk memeriksa apakah Node.js diinstal.

Menyiapkan

Untuk menyiapkan lingkungan untuk mengirim kueri pencarian, lakukan langkah-langkah di bagian berikut.

Membuat aplikasi Node.js baru

Di terminal atau jendela perintah, buat direktori baru untuk aplikasi Anda dan navigasikan ke dalamnya.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Jalankan npm init -y untuk membuat file package.json dengan pengaturan default.

npm init -y

Buat file yang disebut number-lookup-quickstart.js di akar direktori yang Anda buat. Tambahkan cuplikan berikut ke dalamnya:

async function main() {
    // quickstart code will go here
}

main();

Pasang paket

Gunakan perintah npm install untuk memasang pustaka klien Azure Communication Services Phone Numbers untuk JavaScript.

npm install @azure/communication-phone-numbers@1.3.0-beta.4 --save

Opsi --save menambahkan pustaka sebagai dependensi di filepackage.js Anda.

Contoh kode

Mengautentikasi klien

Impor Telepon NumbersClient dari pustaka klien dan buat instans dengan string koneksi Anda, yang dapat diperoleh dari sumber daya Azure Communication Services di portal Azure. COMMUNICATION_SERVICES_CONNECTION_STRING Menggunakan variabel lingkungan disarankan untuk menghindari menempatkan string koneksi Anda dalam teks biasa dalam kode Anda. Pelajari cara mengelola string koneksi sumber daya Anda.

Tambahkan kode berikut ke bagian atas number-lookup-quickstart.js:

const { PhoneNumbersClient } = require('@azure/communication-phone-numbers');

// This code retrieves your connection string from an environment variable
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the phone numbers client
const phoneNumbersClient = new PhoneNumbersClient(connectionString);

Mencari pemformatan nomor telepon

Untuk mencari informasi operator nomor telepon, hubungi searchOperatorInformation dari PhoneNumbersClient.

let formattingResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ]);

Ganti <target-phone-number> dengan nomor telepon yang Anda cari, biasanya nomor yang ingin Anda kirimi pesan.

Peringatan

Berikan nomor telepon dalam format standar internasional E.164, misalnya, +14255550123.

Mencari informasi operator untuk nomor

Untuk mencari informasi operator nomor telepon, hubungi searchOperatorInformation dari PhoneNumbersClient, meneruskan trueincludeAdditionalOperatorDetails opsi .

let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ], { "includeAdditionalOperatorDetails": true });

Peringatan

Menggunakan fungsionalitas ini akan dikenakan biaya ke akun Anda.

Menggunakan informasi operator

Anda sekarang dapat menggunakan informasi operator. Untuk panduan mulai cepat ini, kita dapat mencetak beberapa detail ke konsol.

Pertama, kita dapat mencetak detail tentang format angka.

let formatInfo = formattingResults.values[0];
console.log(formatInfo.phoneNumber + " is formatted " + formatInfo.internationalFormat + " internationally, and " + formatInfo.nationalFormat + " nationally");

Selanjutnya, kita dapat mencetak detail tentang nomor telepon dan operator.

let operatorInfo = searchResults.values[0];
console.log(operatorInfo.phoneNumber + " is a " + (operatorInfo.numberType ? operatorInfo.numberType : "unknown") + " number, operated in "
    + operatorInfo.isoCountryCode + " by " + (operatorInfo.operatorDetails.name ? operatorInfo.operatorDetails.name : "an unknown operator"));

Anda juga dapat menggunakan informasi operator untuk menentukan apakah akan mengirim SMS. Untuk informasi selengkapnya tentang mengirim SMS, lihat Mulai Cepat SMS.

Menjalankan kode

Jalankan aplikasi dari terminal atau jendela perintah Anda dengan node perintah .

node number-lookup-quickstart.js

Kode Sampel

Anda dapat mengunduh aplikasi sampel dari GitHub).

Mulai menggunakan pustaka klien Telepon Numbers untuk C# guna mencari informasi operator untuk nomor telepon, yang dapat digunakan untuk menentukan apakah dan cara berkomunikasi dengan nomor telepon tersebut. Ikuti langkah-langkah ini untuk menginstal paket dan mencari informasi operator tentang nomor telepon.

Catatan

Temukan kode untuk mulai cepat ini di GitHub.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Versi terbaru pustaka klien .NET Core untuk sistem operasi Anda.
Sumber daya Communication Services aktif dan string koneksi. Buat sumber daya Azure Communication Services.

Pemeriksaan prasyarat

Di terminal atau jendela perintah, jalankan dotnet perintah untuk memeriksa apakah .NET SDK telah diinstal.

Menyiapkan

Untuk menyiapkan lingkungan untuk mengirim kueri pencarian, lakukan langkah-langkah di bagian berikut.

Membuat aplikasi C# baru

Di terminal atau jendela perintah, jalankan dotnet new perintah untuk membuat aplikasi konsol baru dengan nama NumberLookupQuickstart. Perintah ini membuat proyek C# "Halo Dunia" sederhana dengan file sumber tunggal, Program.cs.

dotnet new console -o NumberLookupQuickstart

Ubah direktori Anda ke folder aplikasi yang baru dibuat dan gunakan perintah dotnet build untuk mengompilasi aplikasi Anda.

cd NumberLookupQuickstart
dotnet build

Koneksi ke umpan paket dev

Versi pratinjau publik SDK diterbitkan ke umpan paket dev. Anda dapat menambahkan umpan dev menggunakan NuGet CLI, yang menambahkannya ke file NuGet.Config.

nuget sources add -Name "Azure SDK for .NET Dev Feed" -Source "https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-net/nuget/v3/index.json"

Informasi lebih rinci dan opsi lain untuk menyambungkan ke umpan dev dapat ditemukan di panduan berkontribusi.

Pasang paket

Saat masih berada di direktori aplikasi, instal pustaka klien Azure Communication Services Telepon Numbers untuk paket .NET dengan menggunakan perintah berikut.

dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.5

Tambahkan arahan using ke bagian atas Program.cs untuk menyertakan ruang nama Azure.Communication.

using System;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;

Perbarui Main tanda tangan fungsi menjadi asinkron.

internal class Program
{
    static async Task Main(string[] args)
    {
        ...
    }
}

Contoh kode

Mengautentikasi klien

Telepon Jumlah klien dapat diautentikasi menggunakan string koneksi diperoleh dari sumber daya Azure Communication Services di portal Azure. COMMUNICATION_SERVICES_CONNECTION_STRING Menggunakan variabel lingkungan disarankan untuk menghindari menempatkan string koneksi Anda dalam teks biasa dalam kode Anda. Pelajari cara mengelola string koneksi sumber daya Anda.

// This code retrieves your connection string from an environment variable.
string? connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient client = new PhoneNumbersClient(connectionString, new PhoneNumbersClientOptions(PhoneNumbersClientOptions.ServiceVersion.V2024_03_01_Preview));

klien Telepon Number juga dapat mengautentikasi dengan autentikasi Microsoft Entra. Dengan opsi ini, AZURE_CLIENT_SECRETvariabel lingkungan , AZURE_CLIENT_ID, dan AZURE_TENANT_ID perlu disiapkan untuk autentikasi.

// Get an endpoint to our Azure Communication Services resource.
Uri endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);

Mencari pemformatan nomor telepon

Untuk mencari pemformatan nasional dan internasional untuk nomor, hubungi SearchOperatorInformationAsync dari PhoneNumbersClient.

OperatorInformationResult formattingResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" });

Ganti <target-phone-number> dengan nomor telepon yang Anda cari, biasanya nomor yang ingin Anda kirimi pesan.

Peringatan

Berikan nomor telepon dalam format standar internasional E.164, misalnya, +14255550123.

Mencari informasi operator untuk nomor

Untuk mencari informasi operator nomor telepon, hubungi SearchOperatorInformationAsync dari PhoneNumbersClient, meneruskan trueIncludeAdditionalOperatorDetails opsi .

OperatorInformationResult searchResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" }, new OperatorInformationOptions() { IncludeAdditionalOperatorDetails = true });

Peringatan

Menggunakan fungsionalitas ini akan dikenakan biaya ke akun Anda.

Menggunakan informasi operator

Anda sekarang dapat menggunakan informasi operator. Untuk panduan mulai cepat ini, kita dapat mencetak beberapa detail ke konsol.

Pertama, kita dapat mencetak detail tentang format angka.

OperatorInformation formattingInfo = formattingResult.Values[0];
Console.WriteLine($"{formattingInfo.PhoneNumber} is formatted {formattingInfo.InternationalFormat} internationally, and {formattingInfo.NationalFormat} nationally");

Selanjutnya, kita dapat mencetak detail tentang nomor telepon dan operator.

OperatorInformation operatorInformation = searchResult.Values[0];
Console.WriteLine($"{operatorInformation.PhoneNumber} is a {operatorInformation.NumberType ?? "unknown"} number, operated in {operatorInformation.IsoCountryCode} by {operatorInformation.OperatorDetails.Name ?? "an unknown operator"}");

Anda juga dapat menggunakan informasi operator untuk menentukan apakah akan mengirim SMS. Untuk informasi selengkapnya tentang mengirim SMS, lihat Mulai Cepat SMS.

Menjalankan kode

Jalankan aplikasi dari terminal atau jendela perintah Anda dengan dotnet run perintah .

dotnet run --interactive

Kode Sampel

Anda dapat mengunduh aplikasi sampel dari GitHub.

Mulai menggunakan pustaka klien Telepon Numbers untuk Java guna mencari informasi operator untuk nomor telepon, yang dapat digunakan untuk menentukan apakah dan cara berkomunikasi dengan nomor telepon tersebut. Ikuti langkah-langkah ini untuk menginstal paket dan mencari informasi operator tentang nomor telepon.

Catatan

Temukan kode untuk mulai cepat ini di GitHub.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Java Development Kit (JDK) versi 8 atau lebih tinggi.
Apache Maven.
Sumber daya Communication Services aktif dan string koneksi. Buat sumber daya Azure Communication Services.

Pemeriksaan prasyarat

Di terminal atau jendela perintah, jalankan mvn -v perintah untuk memeriksa apakah Maven diinstal.

Menyiapkan

Untuk menyiapkan lingkungan untuk mengirim kueri pencarian, lakukan langkah-langkah di bagian berikut.

Membuat aplikasi Java baru

Di terminal atau jendela perintah, navigasikan ke direktori tempat Anda ingin membuat aplikasi Java. Jalankan perintah berikut untuk menghasilkan proyek Java dari templat maven-archetype-quickstart.

mvn archetype:generate -DgroupId=com.communication.lookup.quickstart -DartifactId=communication-lookup-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

Tugas 'hasilkan' membuat direktori dengan nama artifactIdyang sama dengan . Di direktori ini, direktori src/main/java berisi kode sumber proyek, src/test/java directory berisi sumber pengujian, dan file pom.xml tersebut adalah Project Object Model atau POM proyek.

Koneksi ke umpan paket dev

Versi pratinjau publik SDK diterbitkan ke umpan paket dev. Untuk menyambungkan ke umpan dev, buka file pom.xml di editor teks Anda dan tambahkan repositori dev ke bagian dan <distributionManagement> pom.xml <repositories> yang dapat Anda tambahkan jika belum ada.

<repository>
  <id>azure-sdk-for-java</id>
  <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

Anda mungkin perlu menambahkan atau mengedit settings.xml file di ${user.home}/.m2

<server>
  <id>azure-sdk-for-java</id>
  <username>azure-sdk</username>
  <password>[PERSONAL_ACCESS_TOKEN]</password>
</server>

Anda dapat membuat Token Akses Pribadi dengan Cakupan baca &tulis Kemasan dan tempelkan ke <password> tag.

Informasi lebih rinci dan opsi lain untuk menyambungkan ke umpan dev dapat ditemukan di sini.

Pasang paket

Tambahkan elemen dependensi berikut ke grup dependensi dalam file pom.xml .

<dependencies>
  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-common</artifactId>
    <version>1.0.0</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-phonenumbers</artifactId>
    <version>1.2.0-beta.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.2.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core</artifactId>
    <version>1.41.0</version>
  </dependency>
</dependencies>

Periksa bagian properties untuk memastikan proyek Anda menargetkan Maven versi 1.8 atau lebih tinggi.

<properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <maven.compiler.source>1.8</maven.compiler.source>
  <maven.compiler.target>1.8</maven.compiler.target>
</properties>

Contoh kode

Menyiapkan kerangka kerja aplikasi

Dari direktori proyek:

Navigasi ke direktori /src/main/java/com/communication/lookup/quickstart
Buka file App.java di editor Anda
Ganti pernyataan System.out.println("Hello world!");
Tambahkan direktif import

Tambahkan kode berikut ke memulai:

package com.communication.lookup.quickstart;

import com.azure.communication.phonenumbers.*;
import com.azure.communication.phonenumbers.models.*;
import com.azure.core.http.rest.*;
import com.azure.core.util.Context;
import com.azure.identity.*;
import java.io.*;
import java.util.ArrayList;

public class App
{
    public static void main( String[] args ) throws IOException
    {
        System.out.println("Azure Communication Services - Number Lookup Quickstart");
        // Quickstart code goes here
    }
}

Mengautentikasi klien

Klien dapat diautentikasi menggunakan string koneksi yang diperoleh dari sumber daya Azure Communication Services di portal Azure. COMMUNICATION_SERVICES_CONNECTION_STRING Menggunakan variabel lingkungan disarankan untuk menghindari menempatkan string koneksi Anda dalam teks biasa dalam kode Anda. Pelajari cara mengelola string koneksi sumber daya Anda.

// This code retrieves your connection string from an environment variable
String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .connectionString(connectionString)
    .buildClient();

Atau, Anda dapat mengautentikasi menggunakan autentikasi Microsoft Entra. DefaultAzureCredentialBuilder Menggunakan adalah cara term mudah untuk mulai menggunakan MICROSOFT Entra ID. Anda dapat memperoleh nama sumber daya dari sumber daya Azure Communication Services di portal Azure.

// You can find your resource name from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

Mencari pemformatan nomor telepon

Untuk mencari pemformatan nasional dan internasional untuk nomor, hubungi searchOperatorInformation dari PhoneNumbersClient.

ArrayList<String> phoneNumbers = new ArrayList<String>();
phoneNumbers.add("<target-phone-number>");

// Use the free number lookup functionality to get number formatting information
OperatorInformationResult formattingResult = phoneNumberClient.searchOperatorInformation(phoneNumbers);
OperatorInformation formattingInfo = formattingResult.getValues().get(0);

Ganti <target-phone-number> dengan nomor telepon yang Anda cari, biasanya nomor yang ingin Anda kirimi pesan.

Peringatan

Berikan nomor telepon dalam format standar internasional E.164, misalnya, +14255550123.

Mencari informasi operator untuk nomor

Untuk mencari informasi operator nomor telepon, hubungi searchOperatorInformationWithResponse dari PhoneNumbersClient, meneruskan trueIncludeAdditionalOperatorDetails opsi .

OperatorInformationOptions options = new OperatorInformationOptions();
options.setIncludeAdditionalOperatorDetails(true);
Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
OperatorInformation operatorInfo = result.getValue().getValues().get(0);

Peringatan

Menggunakan fungsionalitas ini akan dikenakan biaya ke akun Anda.

Menggunakan informasi operator

Anda sekarang dapat menggunakan informasi operator. Untuk panduan mulai cepat ini, kita dapat mencetak beberapa detail ke konsol.

Pertama, kita dapat mencetak detail tentang format angka.

System.out.println(formattingInfo.getPhoneNumber() + " is formatted "
    + formattingInfo.getInternationalFormat() + " internationally, and "
    + formattingInfo.getNationalFormat() + " nationally");

Selanjutnya, kita dapat mencetak detail tentang nomor telepon dan operator.

String numberType = operatorInfo.getNumberType() == null ? "unknown" : operatorInfo.getNumberType().toString();
String operatorName = "an unknown operator";
if (operatorInfo.getOperatorDetails()!= null && operatorInfo.getOperatorDetails().getName() != null)
{
    operatorName = operatorInfo.getOperatorDetails().getName();
}
System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " number, operated in "
    + operatorInfo.getIsoCountryCode() + " by " + operatorName);

Anda juga dapat menggunakan informasi operator untuk menentukan apakah akan mengirim SMS. Untuk informasi selengkapnya tentang mengirim SMS, lihat Mulai Cepat SMS.

Menjalankan kode

Jalankan aplikasi dari terminal atau jendela perintah Anda dengan perintah berikut: Navigasikan ke direktori yang berisi file pom.xml dan kompilasi proyek.

mvn compile

Kemudian, bangun paketnya.

mvn package

Untuk menjalankan aplikasi, gunakan mvn perintah .

mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false"

Kode Sampel

Anda dapat mengunduh aplikasi sampel dari GitHub.

Mulai menggunakan pustaka klien Telepon Numbers untuk Python guna mencari informasi operator untuk nomor telepon, yang dapat digunakan untuk menentukan apakah dan cara berkomunikasi dengan nomor telepon tersebut. Ikuti langkah-langkah ini untuk menginstal paket dan mencari informasi operator tentang nomor telepon.

Catatan

Temukan kode untuk mulai cepat ini di GitHub.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Python 3.7+.
Sumber daya Communication Services aktif dan string koneksi. Buat sumber daya Azure Communication Services.

Pemeriksaan prasyarat

Di terminal atau jendela perintah, jalankan perintah python --version untuk memeriksa apakah Python dipasang.

Menyiapkan

Untuk menyiapkan lingkungan untuk mengirim kueri pencarian, lakukan langkah-langkah di bagian berikut.

Membuat aplikasi Python baru

Di terminal atau jendela perintah, buat direktori baru untuk aplikasi Anda dan navigasikan ke dalamnya.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Gunakan editor teks untuk membuat file yang disebut number_lookup_sample.py di direktori akar proyek dan menambahkan kode berikut. Kode mulai cepat yang tersisa ditambahkan di bagian berikut.

import os
from azure.communication.phonenumbers import PhoneNumbersClient

try:
   print('Azure Communication Services - Number Lookup Quickstart')
   # Quickstart code goes here
except Exception as ex:
   print('Exception:')
   print(ex)

Pasang paket

Saat masih berada di direktori aplikasi, instal pustaka klien Azure Communication Services Telepon Numbers untuk paket Python dengan menggunakan pip install perintah .

pip install azure-communication-phonenumbers==1.2.0b2

Contoh kode

Mengautentikasi klien

# This code retrieves your connection string from an environment variable
connection_string = os.getenv('COMMUNICATION_SERVICES_CONNECTION_STRING')
try:
    phone_numbers_client = PhoneNumbersClient.from_connection_string(connection_string)
except Exception as ex:
    print('Exception:')
    print(ex)

Atau, klien dapat diautentikasi menggunakan autentikasi Microsoft Entra. DefaultAzureCredential Menggunakan objek adalah cara term mudah untuk mulai menggunakan MICROSOFT Entra ID dan Anda dapat menginstalnya menggunakan pip install perintah .

pip install azure-identity

Membuat DefaultAzureCredential objek mengharuskan Anda memiliki AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, dan AZURE_TENANT_ID sudah ditetapkan sebagai variabel lingkungan dengan nilai yang sesuai dari aplikasi Microsoft Entra terdaftar Anda.

Untuk peningkatan tentang cara mendapatkan variabel lingkungan ini, Anda dapat mempelajari cara menyiapkan perwakilan layanan dari CLI.

azure-identity Setelah pustaka diinstal, Anda dapat terus mengautentikasi klien.

from azure.identity import DefaultAzureCredential

# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
    credential = DefaultAzureCredential()
    phone_numbers_client = PhoneNumbersClient(endpoint, credential)
except Exception as ex:
    print('Exception:')
    print(ex)

Mencari pemformatan nomor telepon

Untuk mencari pemformatan nasional dan internasional untuk nomor, hubungi search_operator_information dari PhoneNumbersClient.

formatting_results = phone_numbers_client.search_operator_information("<target-phone-number>")

Ganti <target-phone-number> dengan nomor telepon yang Anda cari, biasanya nomor yang ingin Anda kirimi pesan.

Peringatan

Berikan nomor telepon dalam format standar internasional E.164, misalnya, +14255550123.

Mencari informasi operator untuk nomor

Untuk mencari informasi operator nomor telepon, hubungi search_operator_information dari PhoneNumbersClient, meneruskan Trueinclude_additional_operator_details opsi .

options = { "include_additional_operator_details": True }
operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options)

Peringatan

Menggunakan fungsionalitas ini akan dikenakan biaya ke akun Anda.

Menggunakan informasi operator

Anda sekarang dapat menggunakan informasi operator. Untuk panduan mulai cepat ini, kita dapat mencetak beberapa detail ke konsol.

Pertama, kita dapat mencetak detail tentang format angka.

formatting_info = formatting_results.values[0]
print(str.format("{0} is formatted {1} internationally, and {2} nationally", formatting_info.phone_number, formatting_info.international_format, formatting_info.national_format))

Selanjutnya, kita dapat mencetak detail tentang nomor telepon dan operator.

operator_information = operator_results.values[0]

number_type = operator_information.number_type if operator_information.number_type else "unknown"
if operator_information.operator_details is None or operator_information.operator_details.name is None:
    operator_name = "an unknown operator"
else:
    operator_name = operator_information.operator_details.name

print(str.format("{0} is a {1} number, operated in {2} by {3}", operator_information.phone_number, number_type, operator_information.iso_country_code, operator_name))

Anda juga dapat menggunakan informasi operator untuk menentukan apakah akan mengirim SMS. Untuk informasi selengkapnya tentang mengirim SMS, lihat Mulai Cepat SMS.

Menjalankan kode

Jalankan aplikasi dari terminal atau jendela perintah Anda dengan python perintah .

python number_lookup_sample.py

Kode Sampel

Anda dapat mengunduh aplikasi sampel dari GitHub.

Pemecahan Masalah

Pertanyaan dan masalah umum:

Perubahan pada variabel lingkungan mungkin tidak berlaku dalam program yang sudah berjalan. Jika Anda melihat variabel lingkungan Anda tidak berfungsi seperti yang diharapkan, coba tutup dan buka kembali program apa pun yang Anda gunakan untuk menjalankan dan mengedit kode.
Data yang dikembalikan oleh titik akhir ini tunduk pada berbagai hukum dan peraturan internasional, oleh karena itu akurasi hasil tergantung pada beberapa faktor. Faktor-faktor ini termasuk apakah nomor tersebut di-port, kode negara, dan status persetujuan pemanggil. Berdasarkan faktor-faktor ini, informasi operator mungkin tidak tersedia untuk beberapa nomor telepon atau mungkin mencerminkan operator asli nomor telepon, bukan operator saat ini.

Langkah berikutnya

Dalam panduan mulai cepat ini, Anda telah mempelajari cara:

Mencari pemformatan angka
Mencari informasi operator untuk nomor telepon

Konsep Pencarian Angka

Pencarian Nomor SDK

Mulai cepat: Mencari informasi operator untuk nomor telepon menggunakan Azure Communication Services

Prasyarat

Pemeriksaan prasyarat

Menyiapkan

Membuat aplikasi Node.js baru

Pasang paket

Contoh kode

Mengautentikasi klien

Mencari pemformatan nomor telepon

Mencari informasi operator untuk nomor

Menggunakan informasi operator

Menjalankan kode

Kode Sampel

Prasyarat

Pemeriksaan prasyarat

Menyiapkan

Membuat aplikasi C# baru

Koneksi ke umpan paket dev

Pasang paket

Contoh kode

Mengautentikasi klien

Mencari pemformatan nomor telepon

Mencari informasi operator untuk nomor

Menggunakan informasi operator

Menjalankan kode

Kode Sampel

Prasyarat

Pemeriksaan prasyarat

Menyiapkan

Membuat aplikasi Java baru

Koneksi ke umpan paket dev

Pasang paket

Contoh kode

Menyiapkan kerangka kerja aplikasi

Mengautentikasi klien

Mencari pemformatan nomor telepon

Mencari informasi operator untuk nomor

Menggunakan informasi operator

Menjalankan kode

Kode Sampel

Prasyarat

Pemeriksaan prasyarat

Menyiapkan

Membuat aplikasi Python baru

Pasang paket

Contoh kode

Mengautentikasi klien

Mencari pemformatan nomor telepon

Mencari informasi operator untuk nomor

Menggunakan informasi operator

Menjalankan kode

Kode Sampel

Pemecahan Masalah

Langkah berikutnya

Sumber Daya Tambahan: